PHP MySQLi 函数

PHP mysqli::$sqlstate / mysqli_sqlstate() 函数返回最近 MySQLi 函数的 SQLSTATE 错误代码调用可能成功也可能失败。错误代码由五个字符组成。 "00000"表示没有错误。这些值由 ANSI SQL 和 ODBC 指定。

注意:并非所有 MySQL 错误都映射到 SQLSTATE。值 HY000（一般错误）用于未映射的错误。

语法

//面向对象风格
$mysqli->sqlstate;

//面向过程风格
mysqli_sqlstate(mysql)

参数

mysql必填。 仅适用于面向过程风格:指定 mysqli_connect() 或 mysqli_init() 返回的 mysqli 对象。

返回值

返回一个字符串，其中包含最后一个错误的 SQLSTATE 错误代码。错误代码由五个字符组成。 '00000'表示没有错误。

示例:面向对象风格

下面的示例显示了mysqli::$sqlstate属性的用法。

<?php
//建立与数据库的连接
$mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->connect_sqlstate) {
  echo "Failed to connect to MySQL: ". $mysqli->connect_error;
  exit();
}

//执行SQL查询
$sql = "SET x=1";

if (!$mysqli->query($sql)) {
  printf("Error - SQLSTATE %s.\n", $mysqli->sqlstate);
}

//关闭连接
$mysqli->close();
?>

上述代码的输出将类似于:

Error - SQLSTATE HY000.

示例:面向过程风格

下面的示例显示了 的用法mysqli_sqlstate() 函数。

<?php
//建立与数据库的连接
$mysqli = mysqli_connect("localhost", "user", "password", "database");
if (mysqli_connect_sqlstate()) {
  echo "Failed to connect to MySQL: ". mysqli_connect_error();
  exit();
}

//执行SQL查询
$sql = "SET x=1";

if (!mysqli_query($mysqli, $sql)) {
  printf("Error - SQLSTATE %s.\n", mysqli_sqlstate($mysqli));
}

//关闭连接
mysqli_close($mysqli);
?>

上述代码的输出将类似于:

Error - SQLSTATE HY000.