(PHP 5, PHP 7, PHP 8)
mysqli::query -- mysqli_query — Executa uma consulta no banco de dados
Estilo orientado a objetos
Estilo procedural
Executa uma query
no banco de dados.
Se a consulta contiver qualquer entrada de variável, instruções preparadas parametrizadas devem ser usadas. Alternativamente, os dados devem ser formatados corretamente e todas as strings devem ser escapadas usando a função mysqli_real_escape_string().
Para consultas não-DML (não INSERT, UPDATE ou DELETE), esta função é semelhante a chamar mysqli_real_query() seguido por mysqli_use_result() ou mysqli_store_result().
Nota:
No caso em que uma instrução é passada para mysqli_query() que é maior que
max_allowed_packet
do servidor, os códigos de erro retornados são diferentes dependendo se você está usando MySQL Native Driver (mysqlnd
)ou MySQL Client Library (libmysqlclient
). O comportamento é o seguinte:
mysqlnd
no Linux retorna um código de erro de 1153. A mensagem de erro significa querecebi um pacote maior que.max_allowed_packet
bytes
mysqlnd
no Windows retorna um código de erro 2006. Esta mensagem de erro significa que oserver has gone away.
libmysqlclient
em todas as plataformas retorna um código de erro 2006. Essa mensagem de erro significa que oservidor foi desativado.
mysql
Somente no estilo procedural: Um objeto mysqli retornado por mysqli_connect() ou mysqli_init()
query
A string de consulta.
result_mode
O modo de resultado pode ser uma das 3 constantes que indicam como o resultado será retornado do servidor MySQL.
MYSQLI_STORE_RESULT
(padrão) - retorna um objeto mysqli_resultcom conjunto de resultados em buffer.
MYSQLI_USE_RESULT
- retorna um objeto mysqli_result com conjunto de resultados sem buffer. Enquanto houver registros pendentes esperando para serem buscados, a linha de conexão estará ocupada e todas as chamadas subseqüentes retornarão o erro Commands out of sync
. Para evitar o erro, todos os registros devem ser buscados no servidor ou o conjunto de resultados deve ser descartado chamando mysqli_free_result().
MYSQLI_ASYNC
(disponível com mysqlnd) - a consulta é executada de forma assíncrona e nenhum conjunto de resultados é retornado imediatamente. mysqli_poll() é então usado para obter resultados de tais consultas. Usado em combinação com a constante MYSQLI_STORE_RESULT
ou MYSQLI_USE_RESULT
.
Retorna false
em caso de falha. Para consultas bem-sucedidas que produzem um conjunto de resultados, como SELECT, SHOW, DESCRIBE
ou EXPLAIN
, mysqli_query() retornará um objeto mysqli_result. Para outras consultas bem-sucedidas, mysqli_query() retornará true
.
Se o relatório de erros da extensão mysqli estiver habilitado (MYSQLI_REPORT_ERROR
) e a operação solicitada falhar, um aviso será gerado. Se, além disso, o modo for definido como MYSQLI_REPORT_STRICT
, uma exceção mysqli_sql_exception será lançada em vez do aviso.
Exemplo #1 mysqli::query() exemplo
Estilo orientado a objetos
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
$mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City");
printf("Tabela myCity criada com sucesso.\n");
$result = $mysqli->query("SELECT Name FROM City LIMIT 10");
printf("Select retornou %d linhas.\n", $result->num_rows);
$result = $mysqli->query("SELECT * FROM City", MYSQLI_USE_RESULT);
$mysqli->query("SET @a:='isso não vai funcionar'");
Estilo procedural
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City");
printf("Tabela myCity criada com sucesso.\n");
$result = mysqli_query($link, "SELECT Name FROM City LIMIT 10");
printf("Select retornou %d linhas.\n", mysqli_num_rows($result));
$result = mysqli_query($link, "SELECT * FROM City", MYSQLI_USE_RESULT);
* Observe que não podemos executar nenhuma função que interaja com o
servidor até que todos os registros tenham sido totalmente recuperados ou o resultado
conjunto foi fechado. Todas as chamadas retornarão um erro 'fora de sincronia'*/
mysqli_query($link, "SET @a:='isso não vai funcionar'");
Os exemplos acima produzirão algo semelhante a:
Tabela myCity criada com sucesso. Select retornou 10 linhas. Erro fatal: mysqli_sql_exception não capturado: Comandos fora de sincronia; você não pode executar este comando agora em ...