mysqli::$sqlstate

mysqli_sqlstate

(PHP 5, PHP 7, PHP 8)

mysqli::$sqlstate -- mysqli_sqlstate — 返回上一次 SQL 操作的 SQLSTATE 錯(cuò)誤信息

說(shuō)明

面向?qū)ο箫L(fēng)格

過(guò)程化風(fēng)格

mysqli_sqlstate(mysqli $link): string

返回一個(gè)包含 SQLSTATE 錯(cuò)誤碼的字符串，表示上一次 SQL 操作的錯(cuò)誤。 錯(cuò)誤碼是由 5 個(gè)字符構(gòu)成，'00000' 表示沒(méi)有發(fā)生錯(cuò)誤。 錯(cuò)誤碼是由 ANSI SQL 和 ODBC 定義的， 詳細(xì)的清單請(qǐng)參見：? http://dev.mysql.com/doc/mysql/en/error-handling.html。

注意:

需要注意的是，并不是所有的 MySQL 錯(cuò)誤都映射到 SQLSTATE 了， 未映射的錯(cuò)誤消息使用 HY000（綜合錯(cuò)誤）表示。

參數(shù)

mysql

僅以過(guò)程化樣式：由mysqli_connect() 或 mysqli_init() 返回的 mysqli 對(duì)象。

返回值

返回一個(gè)包含 SQLSTATE 錯(cuò)誤碼的字符串，表示上一次 SQL 操作的錯(cuò)誤。 錯(cuò)誤碼是由 5 個(gè)字符構(gòu)成，'00000' 表示沒(méi)有發(fā)生錯(cuò)誤。

范例

示例 #1 $mysqli->sqlstate 例程

面向?qū)ο箫L(fēng)格

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

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

/* City 表已經(jīng)存在，所以我們會(huì)遇到一個(gè)錯(cuò)誤 */
if (!$mysqli->query("CREATE TABLE City (ID INT, Name VARCHAR(30))")) {
    printf("Error - SQLSTATE %s.\n", $mysqli->sqlstate);
}

$mysqli->close();
?>

過(guò)程化風(fēng)格

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

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

/* City 表已經(jīng)存在，所以我們會(huì)遇到一個(gè)錯(cuò)誤 */
if (!mysqli_query($link, "CREATE TABLE City (ID INT, Name VARCHAR(30))")) {
    printf("Error - SQLSTATE %s.\n", mysqli_sqlstate($link));
}

mysqli_close($link);
?>

以上例程會(huì)輸出：

Error - SQLSTATE 42S01.

參見

  • mysqli_errno() - 返回最近函數(shù)調(diào)用的錯(cuò)誤代碼
  • mysqli_error() - Returns a string description of the last error