mysqli::$sqlstate

mysqli_sqlstate

(PHP 5, PHP 7, PHP 8)

mysqli::$sqlstate -- mysqli_sqlstate — 返回上一次 SQL 操作的 SQLSTATE 错误信息

说明

面向对象风格

string $mysqli->sqlstate;

过程化风格

mysqli_sqlstate(mysqli $link): string

返回一个包含 SQLSTATE 错误码的字符串，表示上一次 SQL 操作的错误。 错误码是由 5 个字符构成，'00000' 表示没有发生错误。 错误码是由 ANSI SQL 和 ODBC 定义的， 详细的清单请参见：» http://dev.mysql.com/doc/mysql/en/error-handling.html。

注意:

需要注意的是，并不是所有的 MySQL 错误都映射到 SQLSTATE 了， 未映射的错误消息使用 HY000（综合错误）表示。

参数

mysql

仅以过程化样式：由mysqli_connect() 或 mysqli_init() 返回的 mysqli 对象。

返回值

返回一个包含 SQLSTATE 错误码的字符串，表示上一次 SQL 操作的错误。 错误码是由 5 个字符构成，'00000' 表示没有发生错误。

范例

示例 #1 $mysqli->sqlstate 例程

面向对象风格

<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* 检查连接 */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* City 表已经存在，所以我们会遇到一个错误 */
if (!$mysqli->query("CREATE TABLE City (ID INT, Name VARCHAR(30))")) {
    printf("Error - SQLSTATE %s.\n", $mysqli->sqlstate);
}

$mysqli->close();
?>

过程化风格

<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* 检查连接 */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* City 表已经存在，所以我们会遇到一个错误 */
if (!mysqli_query($link, "CREATE TABLE City (ID INT, Name VARCHAR(30))")) {
    printf("Error - SQLSTATE %s.\n", mysqli_sqlstate($link));
}

mysqli_close($link);
?>

以上例程会输出：

Error - SQLSTATE 42S01.

参见