(PECL ibm_db2 >= 1.0.0)
db2_conn_error — Devolver una cadena que contenga el valor SQLSTATE devuelto por el último intento de conexión.
$connection
] ) : string
db2_conn_error() devuelve un valor SQLSTATE que representa
el motivo por el que el último intento de conexión a la base de datos falló. Como
db2_connect() devuelve FALSE
cuando un intento de conexión
falla, no es necesario pasar algún argumento a
db2_conn_error() para que devuelva el valor SQLSTATE.
Si, de todos modos, la conexión fue exitosa pero en algún momento dejó de ser válida,
se puede pasar el parámetro opcional connection
para extraer el
valor SQLSTATE para una conexión específica.
Para verificar el valor representado por SQLSTATE, se puede utilizar el siguiente comando
en alguna ventana de línea de comandos de DB2:
db2 '?
. Además
se puede llamasr a db2_conn_errormsg() para obtener el mensaje de error
explícito asociado al valor SQLCODE.
sqlstate-value
'
connection
Es la conexión que se inició correctamente, pero que en algún momento dejó de ser válida.
Devuelve el valor SQLSTATE que resultó de un intento de conexión fallido. Devuelve una cadena vacía si no hay ningún error asociado con el último intento de conexión.
Ejemplo #1 Extrayendo el valor SQLSTATE de un intento de conexión fallido
El siguiente ejemplo demuestra como obtener el valor SQLSTATE después de pasar parámetros inválidos intencionalmente a db2_connect().
<?php
$conn = db2_connect('badname', 'baduser', 'badpassword');
if (!$conn) {
print "Valor SQLSTATE: " . db2_conn_error();
}
?>
El resultado del ejemplo sería:
SQLSTATE value: 08001