(PECL ibm_db2 >= 1.0.0)
db2_conn_error — Devuelve un string que contiene el valor de SQLSTATE devuelto por el último intento de conexión
db2_conn_error() devuelve el valor de SQLSTATE
que representa la razón por la cual el último intento de conexión a
la base de datos ha fallado. Cuando db2_connect()
devuelve false en caso de un intento de conexión fallido, no se debe
pasar ningún argumento a db2_conn_error() para obtener el
valor de SQLSTATE.
Si por el contrario la conexión fue exitosa pero se ha vuelto inválida con el
tiempo, se puede pasar el argumento de conexión
connection para obtener el valor de SQLSTATE para la
conexión específica.
Para entender los valores de SQLSTATE, se puede ingresar el siguiente comando
en el procesador de línea de comandos de DB2:
db2 '? . También
se puede llamar a la función db2_conn_errormsg()
para obtener un mensaje de error explícito junto con el valor de SQLCODE asociado.
sqlstate-value'
connectionUn recurso de conexión asociado a la conexión que previamente fue exitosa, pero que se ha vuelto inválida con el tiempo.
Devuelve el valor de SQLSTATE resultante de un intento de conexión fallido. Devuelve un string vacío si no hay error asociado con el último intento de conexión.
Ejemplo #1 Obtención del valor de SQLSTATE para un intento de conexión fallido
El siguiente ejemplo muestra cómo devolver un valor de SQLSTATE después de pasar un argumento inválido a la función db2_connect().
<?php
$conn = db2_connect('mauvaisnom', 'mauvaisutilisateur', 'mauvaismotdepasse');
if (!$conn) {
print "Valor de SQLSTATE: " . db2_conn_error();
}
?>El resultado del ejemplo sería:
Valor de SQLSTATE: 08001