PDO::errorCode

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

PDO::errorCode — 获取跟数据库句柄上一次操作相关的 SQLSTATE

说明

PDO::errorCode(): mixed

返回值

返回一个 SQLSTATE，一个由5个字母或数字组成的在 ANSI SQL 标准中定义的标识符。 简要地说，一个 SQLSTATE 由前面两个字符的类值和后面三个字符的子类值组成。

PDO::errorCode() 仅接受在数据库句柄上所执行操作的错误代码。如果创建 PDO 语句对象 通过 PDO::prepare() 或 PDO::query() 并在语句上调用错误 处理, PDO::errorCode() 将不会反映这个错误。 必须调用 PDOStatement::errorCode() 返回操作的错误代码在特定语句句柄上执行.

如果数据库句柄没有进行操作，则返回 null 。

范例

示例 #1 取得一个 SQLSTATE 码

<?php
/* 引发一个错误 -- BONES 数据表不存在 */
$dbh->exec("INSERT INTO bones(skull) VALUES ('lucy')");

echo "\nPDO::errorCode(): ";
print $dbh->errorCode();
?>

以上例程会输出：

PDO::errorCode(): 42S02

参见