大网数据广告活动
PHP 语言与运行手册

mysqli::$sqlstate · 返回上一次 MySQL 操作的 SQLSTATE 错误

· 52CE 我爱测

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

mysqli::$sqlstate

mysqli_sqlstate

(PHP 5, PHP 7, PHP 8)

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

说明

面向对象风格

过程化风格

function mysqli_sqlstate(mysqli $mysql): string

返回包含 SQLSTATE 错误码的字符串,表示上次的错误。错误码由 5 个字符构成。'00000' 表示没有发生错误。错误码由 ANSI SQL 和 ODBC 定义。对可能的值列表,参见 » https://dev.mysql.com/doc/mysql/en/error-handling.html。

注意:

需要注意的是,并不是所有的 MySQL 错误都映射到了 SQLSTATE,未映射的错误消息使用 HY000(常规错误)表示。

参数

mysql

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

返回值

返回包含 SQLSTATE 错误码的字符串,表示上次的错误。 错误码由 5 个字符构成。'00000' 表示没有错误。

示例

示例 #1 $mysqli->sqlstate 示例

面向对象风格

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

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

过程化风格

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

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

以上示例会输出:

Error - SQLSTATE 42S01.

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。