array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.db2-conn-error.php', 1 => 'db2_conn_error', 2 => 'Devuelve un string que contiene el valor de SQLSTATE devuelto por el último intento de conexión', ), 'up' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Funciones de IBM DB2', ), 'prev' => array ( 0 => 'function.db2-commit.php', 1 => 'db2_commit', ), 'next' => array ( 0 => 'function.db2-conn-errormsg.php', 1 => 'db2_conn_errormsg', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/ibm_db2/functions/db2-conn-error.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

db2_conn_error

(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

Descripción

db2_conn_error(?resource $connection = null): string

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 '? sqlstate-value'. 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.

Parámetros

connection
Un recurso de conexión asociado a la conexión que previamente fue exitosa, pero que se ha vuelto inválida con el tiempo.

Valores devueltos

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.

Ejemplos

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 ejemplo anterior mostrará:

Valor de SQLSTATE: 08001

Ver también