db2_conn_error

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

Descripción

db2_conn_error ([ resource $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 '? sqlstate-value'. Además se puede llamasr a db2_conn_errormsg() para obtener el mensaje de error explícito asociado al valor SQLCODE.

Parámetros

connection

Es la conexión que se inició correctamente, pero que en algún momento dejó de ser válida.

Valores devueltos

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.

Ejemplos

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

Ver también