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
$connection
] )
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'
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
- db2_conn_errormsg() - Devolver el último mensaje de error de la conexión y su valor SQLCODE
- db2_connect() - Devolver una conexión a la base de datos
- db2_stmt_error() - Returns a string containing the SQLSTATE returned by an SQL statement
- db2_stmt_errormsg() - Returns a string containing the last SQL statement error message