Fonction mysql_query() PHP

Définition et utilisation

La fonction mysql_query() exécute une requête MySQL.

Syntaxe

mysql_query(query,connection)
Paramètres Description
query Obligatoire. Définir la requête SQL à envoyer. Remarque : la chaîne de requête ne doit pas se terminer par un point-virgule.
connection Optionnel. Définir l'identifiant de connexion SQL. Si non défini, utilise la dernière connexion ouverte.

Explication

Si aucune connexion n'est ouverte, cette fonction essaie d'appeler mysql_connect() sans paramètres pour établir une connexion et l'utiliser.

Valeur de retour

mysql_query() renvoie un identifiant de ressource pour les instructions SELECT, SHOW, EXPLAIN ou DESCRIBE, et renvoie FALSE si l'exécution de la requête échoue.

Pour d'autres types de requêtes SQL, mysql_query() renvoie TRUE si l'exécution est réussie et FALSE en cas d'erreur.

Un retour de valeur non FALSE signifie que la requête est valable et peut être exécutée par le serveur. Cela ne signifie pas qu'il y a eu un impact ou un retour de lignes. Il est possible qu'une requête ait réussi mais n'ait pas eu d'impact ou n'ait retourné aucune ligne.

Avis et commentaires

Remarque :La fonction lit et met en cache automatiquement les ensembles de enregistrements. Pour exécuter une requête non-cachée, utilisez mysql_unbuffered_query().

Exemple

Exemple 1

<?php
$con = mysql_connect("localhost","mysql_user","mysql_pwd");
if (!$con)
  {
  die('Impossible de se connecter: ' . mysql_error());
  }
$sql = "SELECT * FROM Person";
mysql_query($sql,$con);
// Certaines lignes de code
mysql_close($con);
?>

Exemple 2

Créer une nouvelle base de données à l'aide de la fonction mysql_query() :

<?php
$con = mysql_connect("localhost","mysql_user","mysql_pwd");
if (!$con)
  {
  die('Impossible de se connecter: ' . mysql_error());
  }
$sql = "CREATE DATABASE my_db";
if (mysql_query($sql,$con))
  {
  echo "Base de données my_db créée";
  }
else
  {
  echo "Erreur lors de la création de la base de données: " . mysql_error();
  }
?>