(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.
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