PDO::errorInfo

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

PDO::errorInfo — Devuelve las informaciones asociadas al error durante la última operación sobre la base de datos

Descripción

public PDO::errorInfo(): array

Parámetros

Esta función no contiene ningún parámetro.

Valores devueltos

PDO::errorInfo() devuelve un array que contiene informaciones sobre el error ocurrido durante la última operación ejecutada por este manejador de base de datos. El array contiene los siguientes campos:

Elemento	Información
0	Código de error SQLSTATE (un identificador alfanumérico de cinco caracteres definido en el estándar ANSI SQL).
1	Código de error específico del driver.
2	Mensaje de error específico del driver.

Nota:
Si el código de error SQLSTATE no está definido o si no hay un error específico del driver, el elemento siguiente al elemento 0 será definido a null.

PDO::errorInfo() devuelve únicamente las informaciones de los errores para las operaciones ejecutadas directamente sobre un manejador de base de datos. Si se crea un objeto PDOStatement con la función PDO::prepare() o la función PDO::query() y se invoca un error sobre el manejador de consulta, PDO::errorInfo() no devolverá el error desde el manejador de consulta. Se debe llamar a la función PDOStatement::errorInfo() para devolver las informaciones sobre el error para una operación ejecutada sobre un manejador de consulta particular.

Ejemplos

Ejemplo #1 Muestra los campos de errores para una conexión PDO_ODBC sobre una base de datos DB2

<?php
/* Provoca un error -- sintaxis SQL incorrecta */
$stmt = $dbh->prepare('mauvaise syntaxe sql');
if (!$stmt) {
   echo "\nPDO::errorInfo():\n";
   print_r($dbh->errorInfo());
}
?>

El ejemplo anterior mostrará:

PDO::errorInfo():
Array
(
    [0] => 42S02
    [1] => -204
    [2] => [IBM][CLI Driver][DB2/LINUX] SQL0204N  "DANIELS.BONES" is an undefined name.  SQLSTATE=42704
)

Ver también

PDO::errorCode() - Devuelve el SQLSTATE asociado con la última operación sobre la base de datos
PDOStatement::errorCode() - Recupera las informaciones sobre el error asociado durante la última operación sobre la consulta
PDOStatement::errorInfo() - Recupera las informaciones sobre el error asociado durante la última operación sobre la consulta

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 3 notes

down

alagar86 at gmail dot com ¶

14 years ago

Please note : that this example won't work if PDO::ATTR_EMULATE_PREPARES is true. 

You should set it to false

<?php
$dbh->setAttribute(PDO::ATTR_EMULATE_PREPARES,false);
$stmt = $dbh->prepare('bogus sql');
if (!$stmt) {
    echo "\nPDO::errorInfo():\n";
    print_r($dbh->errorInfo());
}
?>

down

quickshiftin at gmail dot com ¶

18 years ago

here are the error codes for sqlite, straight from their site:

The error codes for SQLite version 3 are unchanged from version 2. They are as follows: 
#define SQLITE_OK           0   /* Successful result */
#define SQLITE_ERROR        1   /* SQL error or missing database */
#define SQLITE_INTERNAL     2   /* An internal logic error in SQLite */
#define SQLITE_PERM         3   /* Access permission denied */
#define SQLITE_ABORT        4   /* Callback routine requested an abort */
#define SQLITE_BUSY         5   /* The database file is locked */
#define SQLITE_LOCKED       6   /* A table in the database is locked */
#define SQLITE_NOMEM        7   /* A malloc() failed */
#define SQLITE_READONLY     8   /* Attempt to write a readonly database */
#define SQLITE_INTERRUPT    9   /* Operation terminated by sqlite_interrupt() */
#define SQLITE_IOERR       10   /* Some kind of disk I/O error occurred */
#define SQLITE_CORRUPT     11   /* The database disk image is malformed */
#define SQLITE_NOTFOUND    12   /* (Internal Only) Table or record not found */
#define SQLITE_FULL        13   /* Insertion failed because database is full */
#define SQLITE_CANTOPEN    14   /* Unable to open the database file */
#define SQLITE_PROTOCOL    15   /* Database lock protocol error */
#define SQLITE_EMPTY       16   /* (Internal Only) Database table is empty */
#define SQLITE_SCHEMA      17   /* The database schema changed */
#define SQLITE_TOOBIG      18   /* Too much data for one row of a table */
#define SQLITE_CONSTRAINT  19   /* Abort due to contraint violation */
#define SQLITE_MISMATCH    20   /* Data type mismatch */
#define SQLITE_MISUSE      21   /* Library used incorrectly */
#define SQLITE_NOLFS       22   /* Uses OS features not supported on host */
#define SQLITE_AUTH        23   /* Authorization denied */
#define SQLITE_ROW         100  /* sqlite_step() has another row ready */
#define SQLITE_DONE        101  /* sqlite_step() has finished executing */

down

mazen at mindcraftinc dot com ¶

17 years ago

Some PDO drivers return a larger array. For example, the SQL Server driver returns 5 values.

For example:
<?php
$numRows = $db->exec("DELETE FROM [TableName] WHERE ID between 6 and 17");
print_r($db->errorInfo());
?>

Result:

Array
(
    [0] => 00000
    [1] => 0
    [2] => (null) [0] (severity 0) []
    [3] => 0
    [4] => 0
)

＋add a note