# 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

- 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