php8.5
Home/ Manual/ mysqli / mysqli/ mysqli::$sqlstate

mysqli::$sqlstate

PHP function Edit on GitHub ✎

Returns the SQLSTATE error from previous MySQL operation

Description

Oop

stringmysqli->sqlstate

Procedural

mysqli_sqlstate(mysqli $mysql): string

Returns a string containing the SQLSTATE error code for the last error. The error code consists of five characters. '00000' means no error. The values are specified by ANSI SQL and ODBC. For a list of possible values, see Error.

Note

Note that not all MySQL errors are yet mapped to SQLSTATEs. The value HY000 (general error) is used for unmapped errors.

Parameters

Return Values

Returns a string containing the SQLSTATE error code for the last error. The error code consists of five characters. '00000' means no error.

Examples

$mysqli->sqlstate example

Oop

php
<?php

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

/* Table City already exists, so we should get an error */
try {
    $mysqli->query("CREATE TABLE City (ID INT, Name VARCHAR(30))");
} catch (mysqli_sql_exception) {
    printf("Error - SQLSTATE %s.\n", $mysqli->sqlstate);
}

Procedural

php
<?php

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

/* Table City already exists, so we should get an error */
try {
    mysqli_query($link, "CREATE TABLE City (ID INT, Name VARCHAR(30))");
} catch (mysqli_sql_exception) {
    printf("Error - SQLSTATE %s.\n", mysqli_sqlstate($link));
}

Outputs

output
Error - SQLSTATE 42S01.

See Also

Source: reference/mysqli/mysqli/sqlstate.xml · from the official PHP manual (php/doc-en)