PDO::errorInfo

(no version information, might be only in CVS)

PDO::errorInfo --  Fetch extended error information associated with the last operation on the database handle

Description

array PDO::errorInfo ( void )

Warning

This function is EXPERIMENTAL. The behaviour of this function, the name of this function, and anything else documented about this function may change without notice in a future release of PHP. Use this function at your own risk.

Return Values

PDO::errorInfo() returns an array of error information about the last operation performed by this database handle. The array consists of the following fields:

ElementInformation
0SQLSTATE error code (a five-character alphanumeric identifier defined in the ANSI SQL standard).
1Driver-specific error code.
2Driver-specific error message.

PDO::errorInfo() only retrieves error information for operations performed directly on the database handle. If you create a PDOStatement object through PDO::prepare() or PDO::query() and invoke an error on the statement handle, PDO::errorInfo() will insert an error code of PDO_ERR_NONE into the first element of the returned array. You must call PDOStatement::errorInfo() to return the error information for an operation performed on a particular statement handle.

Examples

Example 1. Displaying errorInfo() fields for a PDO_ODBC connection to a DB2 database

<?php
/* Provoke an error -- the BONES table does not exist */
$err = $dbh->prepare('SELECT skull FROM bones');
$err->execute();
echo
"\nPDO::errorInfo():\n";
print_r($err->errorInfo());
?>

The above example will output:

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

See Also

PDO::errorCode()
PDOStatement::errorCode()
PDOStatement::errorInfo()