Manuel PHP

MySQLi
PHP Manual

mysqli::query

mysqli_query

(PHP 5)

mysqli::query -- mysqli_query — Exécute une requête sur la base de données

Description

Style orienté objet :

mixed mysqli::query ( string $query [, int $resultmode ] )

Style procédural :

mixed mysqli_query ( mysqli $link , string $query [, int $resultmode ] )

Exécute une requête sur la base de données.

En termes de fonctionnalités, utiliser cette fonction revient à appeler mysqli_real_query() suivie de mysqli_use_result() ou mysqli_store_result().

Liste de paramètres

link

Style procédural uniquement : Un identifiant de lien retourné par la fonction mysqli_connect() ou par la fonction mysqli_init()

query

La requête, sous la forme d'une chaîne de caractères.

resultmode

Soit la constante MYSQLI_USE_RESULT, soit la constante MYSQLI_STORE_RESULT, suivant le comportement désiré. Par défaut, la constante MYSQLI_STORE_RESULT est utilisé.

Si vous utilisez la constante MYSQLI_USE_RESULT, tous les appels suivants retourneront une erreur Commands out of sync tant que vous n'aurez pas appelé la fonction mysqli_free_result().

Valeurs de retour

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec. Pour SELECT, SHOW, DESCRIBE ou EXPLAIN, mysqli_query() retournera un résultat sous la forme d'un objet.

Exemples

Exemple #1 Style orienté objet

  1. <?php
  2. $mysqli = new mysqli("localhost", "my_user", "my_password", "world");  
  3.  
  4. /* Vérification de la connexion */  
  5. if (mysqli_connect_errno()) { 
  6.    printf("Échec de la connexion : %s\n", mysqli_connect_error()); 
  7.    exit();  
  8. }  
  9.  
  10. /* "Create table" ne retournera aucun jeu de résultats */  
  11. if ($mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) { 
  12.    printf("Table myCity créée avec succès.\n");  
  13. }  
  14.  
  15. /* Requête "Select" retourne un jeu de résultats */  
  16. if ($result = $mysqli->query("SELECT Name FROM City LIMIT 10")) { 
  17.    printf("Select a retourné %d lignes.\n", $result->num_rows); 
  18.  
  19.    /* Libération du jeu de résultats */ 
  20.    $result->close();  
  21. }  
  22.  
  23. /* Si nous avons à récupérer beaucoup de données, nous utilisons MYSQLI_USE_RESULT */  
  24. if ($result = $mysqli->query("SELECT * FROM City", MYSQLI_USE_RESULT)) { 
  25.  
  26.    /* Notez que nous ne pouvons exécuter aucune fonction qui agit sur le serveur tant que
  27.       le jeu de résultats est clos. Tous les appels retourneront un 'out of sync'
  28.    */ 
  29.    if (!$mysqli->query("SET @a:='this will not work'")) { 
  30.       printf("Erreur : %s\n", $mysqli->error); 
  31.    } 
  32.    $result->close();  
  33. }  
  34.  
  35. $mysqli->close();  
  36. ?> 

Exemple #2 Style procédural

  1. <?php
  2. $link = mysqli_connect("localhost", "my_user", "my_password", "world");  
  3.  
  4. /* Vérification de la connexion */  
  5. if (mysqli_connect_errno()) { 
  6.    printf("Échec de la connexion : %s\n", mysqli_connect_error()); 
  7.    exit();  
  8. }  
  9.  
  10. /* "Create table" ne retournera aucun jeu de résultats */  
  11. if (mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) { 
  12.    printf("Table myCity créée avec succès.\n");  
  13. }  
  14.  
  15. /* Requête "Select" retourne un jeu de résultats */  
  16. if ($result = mysqli_query($link, "SELECT Name FROM City LIMIT 10")) { 
  17.    printf("Select a retourné %d lignes.\n", mysqli_num_rows($result)); 
  18.  
  19.    /* Libération du jeu de résultats */ 
  20.    mysqli_free_result($result);  
  21. }  
  22.  
  23. /* Si nous avons à récupérer beaucoup de données, nous utilisons MYSQLI_USE_RESULT */  
  24. if ($result = mysqli_query($link, "SELECT * FROM City", MYSQLI_USE_RESULT)) { 
  25.  
  26.    /* Notez que nous ne pouvons exécuter aucune fonction qui agit sur le serveur tant que
  27.       le jeu de résultats est clos. Tous les appels retourneront un 'out of sync'
  28.    */ 
  29.    if (!mysqli_query($link, "SET @a:='this will not work'")) { 
  30.       printf("Erreur : %s\n", mysqli_error($link)); 
  31.    } 
  32.    mysqli_free_result($result);  
  33. }  
  34.  
  35. mysqli_close($link);  
  36. ?> 

L'exemple ci-dessus va afficher :

Table myCity créée avec succès. Select a retourné 10 lignes. Erreur : Commands out of sync; You can't run this command now

Voir aussi

MySQLi
PHP Manual

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique