mysqli::$sqlstate

mysqli_sqlstate

(PHP 5, PHP 7, PHP 8)

mysqli::$sqlstate -- mysqli_sqlstate返回上一次 SQL 操作的 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.

参见