PHP Conference Nagoya 2025

mysqli_stmt::$sqlstate

mysqli_stmt_sqlstate

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::$sqlstate -- mysqli_stmt_sqlstateRetorna o erro SQLSTATE da operação da instrução anterior

Descrição

Estilo orientado a objetos

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

Exemplo #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();
?>

Exemplo #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

Nota:

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

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top