PHP 8.4.1 Released!

PDOStatement::errorCode

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

PDOStatement::errorCode 文ハンドラにおける直近の操作に関連する SQLSTATE を取得する

説明

public PDOStatement::errorCode(): ?string

パラメータ

この関数にはパラメータはありません。

戻り値

PDOStatement::errorCode() は PDOStatement オブジェクトを用いて実行された操作に対する エラーコードを取得することを除き、 PDO::errorCode() と等価です。

例1 SQLSTATE コードを取得する

<?php
/* エラーを発生させる -- BONES テーブルは存在しない */
$err = $dbh->prepare('SELECT skull FROM bones');
$err->execute();

echo
"\nPDOStatement::errorCode(): ";
print
$err->errorCode();
?>

上の例の出力は以下となります。

PDOStatement::errorCode(): 42S02

参考

  • PDO::errorCode() - データベースハンドラにおける直近の操作に関連する SQLSTATE を取得する
  • PDO::errorInfo() - データベースハンドラにおける直近の操作に関連する拡張エラー情報を取得する
  • PDOStatement::errorInfo() - 文ハンドラにおける直近の操作に関連する拡張エラー情報を取得する

add a note

User Contributed Notes 2 notes

up
16
vaclav dot sir at gmail dot com
18 years ago
Statement's errorCode() returns an empty string before execution, and '00000' (five zeros) after a sucessfull execution:

<?php
$stmt
= $pdo->prepare($query);
assert($stmt->errorCode === '');

$stmt->execute();
assert($stmt->errorCode === '00000');
?>
up
1
dbeecher at tekops dot com
16 years ago
Neither this property nor the PDOStatement::errorInfo() properties are available if you create your own exception handler.

I am using PHP 5.2.4, PDO_INFORMIX 1.2.0.

Making this call at any point in the program after setting your own exception handler produces an error:

PHP Notice: Undefined property: PDOStatement::$errorCode in new_query.php on line

or

PHP Notice: Undefined property: PDOStatement::$errorInfo in new_query.php on line

But if I set the PDO to SILENT, only set error codes with:

$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT)

Then process with if/else the call to this functions works fine. The examples below only do error checking to show the result codes of this function. Normally you would want more.

FAILS:

$dbh = new PDO("informix...")
$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

try {
$result = $dbh->query("asdfkjasdfkjasdfjk"); /* obvious sql error */
if ($result) print "success!";
}
catch
{
$myeCode = $dbh->errorCode();
/* do stuff with error */
};

$dbh=0;

The error handler gets called but knows nothing about $dbh->errorCode or $dbh->errorInfo.

WORKS:

$dbh = new PDO("informix...")
$dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT);

$result = $dbh->query("asdfkjasdfkjasdfjk"); /* obvious sql error */
if ($result)
{
/* process result */
print "success!";

/* all done, didn't make any changes */
$dbh->rollback();
}
else
{
$myeCode = $dbh->errorCode();
print_r($myeCode);
};

$dbh=0; /* close connection */

I hope this helps someone else.
Cheers,
David
To Top