Função mysql_query() do PHP
Definição e uso
A função mysql_query() executa uma consulta MySQL.
Sintaxe
mysql_query(query,connection)
| Parâmetros | Descrição |
|---|---|
| query | Obrigatório. Especifica a consulta SQL a ser enviada. Nota: a string de consulta não deve terminar com ponto e vírgula. |
| connection | Opcional. Especifica o identificador de conexão SQL. Se não for especificado, usa a conexão aberta anterior. |
Descrição
Se não houver nenhuma conexão aberta, a função tentará chamar a função mysql_connect() sem parâmetros para estabelecer uma conexão e usá-la.
Valor de retorno
A função mysql_query() retorna um identificador de recurso para comandos SELECT, SHOW, EXPLAIN ou DESCRIBE, se a consulta não for executada corretamente, retorna FALSE.
Para outros tipos de instruções SQL, mysql_query() retorna TRUE ao executar com sucesso e FALSE ao encontrar um erro.
Um valor de retorno não FALSE significa que a consulta é válida e pode ser executada pelo servidor. Isso não indica nada sobre o número de linhas afetadas ou retornadas. É possível que uma consulta tenha sido executada com sucesso mas não tenha afetado ou retornado nenhuma linha.
Dicas e Notas
Notas:A função lê e armazena automaticamente o conjunto de registros. Para executar consultas não armazenadas, use mysql_unbuffered_query().
Exemplo
Exemplo 1
<?php
$con = mysql_connect("localhost","mysql_user","mysql_pwd");
if (!$con)
{
die('Não foi possível conectar: ' . mysql_error());
}
$sql = "SELECT * FROM Person";
mysql_query($sql,$con);
// Alguns código
mysql_close($con);
?>
Exemplo 2
Criar um novo banco de dados usando a função mysql_query():
<?php
$con = mysql_connect("localhost","mysql_user","mysql_pwd");
if (!$con)
{
die('Não foi possível conectar: ' . mysql_error());
}
$sql = "CREATE DATABASE my_db";
if (mysql_query($sql,$con))
{
echo "Banco de dados my_db criado";
}
else
{
echo "Erro ao criar banco de dados: " . mysql_error();
}
?>
