mysqli_stmt::$sqlstate

mysqli_stmt_sqlstate

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::$sqlstate -- mysqli_stmt_sqlstate — Retorna o erro SQLSTATE da operação da instrução anterior

Descrição

Estilo orientado a objetos

string $mysqli_stmt->sqlstate;

Estilo procedural

mysqli_stmt_sqlstate(mysqli_stmt $statement): string

Retorna uma string contento o código de erro SQLSTATE para a função de instrução preparada mais recentemente chamada, que possa ter sucesso ou falhar. O código de erro consiste de cinco caracteres. '00000' significa que não houve erro. Os valores são especificados pela ANSI SQL e pela ODBC. Para uma lista de valores possíveis, consulte » http://dev.mysql.com/doc/mysql/en/error-handling.html.

Parâmetros

statement

Somente no estilo procedural: Um objeto mysqli_stmt retornado por mysqli_stmt_init().

Valor Retornado

Retorna uma string contendo o código de erro SQLSTATE para o último erro. O código de erro consiste de cinco caracteres. '00000' significa que não houve erro.

Exemplos

Example #1 Estilo orientado a objetos

<?php
/* abre uma conexão */
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* verifica a conexão */
if (mysqli_connect_errno()) {
    printf("Conexão falhou: %s\n", mysqli_connect_error());
    exit();
}

$mysqli->query("CREATE TABLE myCountry LIKE Country");
$mysqli->query("INSERT INTO myCountry SELECT * FROM Country");


$query = "SELECT Name, Code FROM myCountry ORDER BY Name";
if ($stmt = $mysqli->prepare($query)) {

    /* apaga a tabela */
    $mysqli->query("DROP TABLE myCountry");

    /* executa a instrução */
    $stmt->execute();

    printf("Erro: %s.\n", $stmt->sqlstate);

    /* fecha a instrução */
    $stmt->close();
}

/* fecha a conexão */
$mysqli->close();
?>

Example #2 Estilo procedural

<?php
/* abre uma conexão */
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* verifica a conexão */
if (mysqli_connect_errno()) {
    printf("Conexão falhou: %s\n", mysqli_connect_error());
    exit();
}

mysqli_query($link, "CREATE TABLE myCountry LIKE Country");
mysqli_query($link, "INSERT INTO myCountry SELECT * FROM Country");


$query = "SELECT Name, Code FROM myCountry ORDER BY Name";
if ($stmt = mysqli_prepare($link, $query)) {

    /* apaga a tabela */
    mysqli_query($link, "DROP TABLE myCountry");

    /* executa a instrução */
    mysqli_stmt_execute($stmt);

    printf("Error: %s.\n", mysqli_stmt_sqlstate($stmt));

    /* fecha a instrução */
    mysqli_stmt_close($stmt);
}

/* fecha a conexão */
mysqli_close($link);
?>

Os exemplos acima produzirão:

Erro: 42S02.

Notas

Note:

Observe que nem todos os erros do MySQL são mapeados para erros SQLSTATE. O valor HY000 (erro geral) é usado para erros não mapeados.

Veja Também