Edit Report a Bug

    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 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
    add a note add a note
    To Top