pdostatement.errorinfo(3) [php man page]

PDOSTATEMENT.ERRORINFO(3)						 1						 PDOSTATEMENT.ERRORINFO(3)

PDOStatement::errorInfo - Fetch extended error information associated with the last operation on the statement handle

SYNOPSIS

       public array PDOStatement::errorInfo (void  )

DESCRIPTION

RETURN VALUES

       PDOStatement.errorInfo(3) returns an array of error information about the last operation performed by this statement handle. The array con-
       sists of the following fields:

       +--------+---------------------------------------------------+
       |Element |						    |
       |	|						    |
       |	|		     Information		    |
       |	|						    |
       +--------+---------------------------------------------------+
       |   0	|						    |
       |	|						    |
       |	| SQLSTATE error code (a five  characters  alphanu- |
       |	| meric  identifier  defined  in the ANSI SQL stan- |
       |	| dard).					    |
       |	|						    |
       |   1	|						    |
       |	|						    |
       |	|	     Driver specific error code.	    |
       |	|						    |
       |   2	|						    |
       |	|						    |
       |	|	   Driver specific error message.	    |
       |	|						    |
       +--------+---------------------------------------------------+
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 */
	      $sth = $dbh->prepare('SELECT skull FROM bones');
	      $sth->execute();

	      echo "
PDOStatement::errorInfo():
";
	      $arr = $sth->errorInfo();
	      print_r($arr);
	      ?>

	      The above example will output:

	      PDOStatement::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(3), PDO.errorInfo(3), PDOStatement.errorCode(3).

PHP Documentation Group 												 PDOSTATEMENT.ERRORINFO(3)

PDO.ERRORINFO(3)							 1							  PDO.ERRORINFO(3)

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

SYNOPSIS

       public array PDO::errorInfo (void  )

DESCRIPTION

RETURN VALUES

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

       +--------+---------------------------------------------------+
       |Element |						    |
       |	|						    |
       |	|		     Information		    |
       |	|						    |
       +--------+---------------------------------------------------+
       |   0	|						    |
       |	|						    |
       |	| SQLSTATE error code (a five  characters  alphanu- |
       |	| meric  identifier  defined  in the ANSI SQL stan- |
       |	| dard).					    |
       |	|						    |
       |   1	|						    |
       |	|						    |
       |	|	     Driver-specific error code.	    |
       |	|						    |
       |   2	|						    |
       |	|						    |
       |	|	   Driver-specific error message.	    |
       |	|						    |
       +--------+---------------------------------------------------+
       Note

	       If the SQLSTATE error code is not set or there is no driver-specific error, the elements following element 0 will be set to NULL.

       PDO.errorInfo(3) only retrieves error information for operations performed directly on the database handle. If you  create  a  PDOStatement
       object through PDO.prepare(3) or PDO.query(3) and invoke an error on the statement handle, PDO.errorInfo(3) will not reflect the error from
       the statement handle. You must call PDOStatement.errorInfo(3) 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 -- bogus SQL syntax */
	      $stmt = $dbh->prepare('bogus sql');
	      if (!$stmt) {
		  echo "
PDO::errorInfo():
";
		  print_r($dbh->errorInfo());
	      }
	      ?>

	      The above example will output:

	      PDO::errorInfo():
	      Array
	      (
		  [0] => HY000
		  [1] => 1
		  [2] => near "bogus": syntax error
	      )

SEE ALSO

       PDO.errorCode(3), PDOStatement.errorCode(3), PDOStatement.errorInfo(3).

PHP Documentation Group 													  PDO.ERRORINFO(3)