mysqli::$sqlstate()
(PHP 5, PHP 7)
返回上一次 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。
Note:需要注意的是,并不是所有的 MySQL 错误都映射到 SQLSTATE 了,未映射的错误消息使用HY000(综合错误)表示。
参数
- $link
仅以过程化样式:由mysqli_connect()或mysqli_init()返回的链接标识。
返回值
返回一个包含 SQLSTATE 错误码的字符串,表示上一次 SQL 操作的错误。错误码是由 5 个字符构成,'00000'表示没有发生错误。
范例
Example #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.
参见
- mysqli_errno() 返回最近函数调用的错误代码
- mysqli_error() Returns a string description of the last error