mysqli::query

mysqli_query

(PHP 5, PHP 7, PHP 8)

mysqli::query -- mysqli_query — ExĂ©cute une requĂȘte sur la base de donnĂ©es

Description

Style orienté objet

public function mysqli::query(string $query, int $result_mode = MYSQLI_STORE_RESULT): mysqli_result|bool

Style procédural

function mysqli_query(mysqli $mysql, string $query, int $result_mode = MYSQLI_STORE_RESULT): mysqli_result|bool

ExĂ©cute une requĂȘte sur la base de donnĂ©es.

Avertissement

Avertissement de Sécurité : injection SQL

Si la requĂȘte contiens des variables d'entrĂ©es alors des dĂ©clarations prĂ©parĂ©es paramĂ©trisĂ©es devrait ĂȘtre utilisĂ© Ă  la place. Alternativement, les donnĂ©es doivent ĂȘtre correctement formatĂ©es et toutes les chaĂźnes de caractĂšres doivent ĂȘtre Ă©chappĂ©es en utilisant la fonction mysqli_real_escape_string().

Pour les requĂȘtes non-DML (qui n'est pas un INSERT, un UPDATE ou un DELETE), cette fonction est similaire Ă  appeler mysqli_real_query() suivie de mysqli_use_result() ou mysqli_store_result().

Note:

Si on passe une requĂȘte Ă  mysqli_query() qui est plus longue que max_allowed_packet, les codes d'erreur en retour seront diffĂ©rents selon que l'on utilise MySQL Native Driver (mysqlnd) ou la MySQL Client Library (libmysqlclient). Le comportement est dĂ©fini comme suit:

  • mysqlnd sur Linux retourne un code d'erreur de 1153. Le message d'erreur sera got a packet bigger than max_allowed_packet bytes.

  • mysqlnd sur Windows retourne un code d'erreur de 2006. Le message sera du type server has gone away.

  • libmysqlclient sur toute plateforme retourne le code d'erreur 2006. Le message sera du type server has gone away.

Liste de paramĂštres

mysql
Seulement en style procédural : Un objet mysqli retourné par la fonction mysqli_connect() ou mysqli_init().
query

La requĂȘte, sous la forme d'une chaĂźne de caractĂšres.

result_mode

Le mode de rĂ©sultat peut ĂȘtre l'une des 3 constantes indiquant comment le rĂ©sultat sera retournĂ© par le serveur MySQL.

MYSQLI_STORE_RESULT (par défaut) - renvoie un objet mysqli_result avec un ensemble de résultats mis en mémoire tampon.

MYSQLI_USE_RESULT - renvoie un objet mysqli_result avec un ensemble de rĂ©sultats non tamponnĂ©s. Tant qu'il y a des enregistrements en attente d'ĂȘtre rĂ©cupĂ©rĂ©s, la ligne de connexion sera occupĂ©e et tous les appels suivants renverront l'erreur Commands out of sync. Pour Ă©viter l'erreur, tous les enregistrements doivent ĂȘtre rĂ©cupĂ©rĂ©s du serveur ou l'ensemble de rĂ©sultats doit ĂȘtre Ă©cartĂ© en appelant la mysqli_free_result().

MYSQLI_ASYNC (disponible avec mysqlnd) - la requĂȘte est exĂ©cutĂ©e de maniĂšre asynchrone et aucun ensemble de rĂ©sultats n'est immĂ©diatement renvoyĂ©. mysqli_poll() est alors utilisĂ©e pour obtenir les rĂ©sultats de telles requĂȘtes. UtilisĂ©e en combinaison avec la constante MYSQLI_STORE_RESULT ou MYSQLI_USE_RESULT.

Valeurs de retour

Retourne false en cas d'Ă©chec. Pour des requĂȘtes rĂ©ussies qui produisent un jeu de rĂ©sultat tel que SELECT, SHOW, DESCRIBE ou EXPLAIN, mysqli_query() retourne un objet mysqli_result. Pour les autres types de requĂȘtes ayant rĂ©ussi, mysqli_query() retourne true.

Erreurs / Exceptions

Si le rapport d'erreurs mysqli est activé (MYSQLI_REPORT_ERROR) et que l'opération demandée échoue, un avertissement est généré. Si, en plus, le mode est défini sur MYSQLI_REPORT_STRICT, une mysqli_sql_exception est lancée à la place.

Exemples

Exemple #1 Exemple avec mysqli::query()

Style orienté objet

<?php

mysqli_report
(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* "Create table" ne retourne aucun jeu de résultats */
$mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City");
printf("Table myCity créée avec succÚs.\n");

/* RequĂȘte "Select" retourne un jeu de rĂ©sultats */
$result = $mysqli->query("SELECT Name FROM City LIMIT 10");
printf("Select a retourné %d lignes.\n", $result->num_rows);

/* Si nous avons à récupérer beaucoup de données, nous utilisons MYSQLI_USE_RESULT */
$result = $mysqli->query("SELECT * FROM City", MYSQLI_USE_RESULT);

/* Notez que nous ne pouvons exécuter aucune fonction qui agit sur le serveur tant que
le jeu de résultats n'est pas clos. Tous les appels retournent un 'out of sync' */
$mysqli->query("SET @a:='this will not work'");

Style procédural

<?php

mysqli_report
(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* "Create table" ne retourne aucun jeu de résultats */
mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City");
printf("Table myCity créée avec succÚs.\n");

/* RequĂȘte "Select" retourne un jeu de rĂ©sultats */
$result = mysqli_query($link, "SELECT Name FROM City LIMIT 10");
printf("Select a retourné %d lignes.\n", mysqli_num_rows($result));

/* Si nous avons à récupérer beaucoup de données, nous utilisons MYSQLI_USE_RESULT */
$result = mysqli_query($link, "SELECT * FROM City", MYSQLI_USE_RESULT);

/* Notez que nous ne pouvons exécuter aucune fonction qui agit sur le serveur tant que
le jeu de résultats n'est pas clos. Tous les appels retournent un 'out of sync' */
mysqli_query($link, "SET @a:='this will not work'");

Les exemples ci-dessus vont afficher :

Table myCity créée avec succÚs.
Select a retourné 10 lignes.
Fatal error: Uncaught mysqli_sql_exception: Commands out of sync; you can't run this command now in...

Voir aussi

add a note

User Contributed Notes 8 notes

up
52
NUNTIUS ¶
18 years ago
This may or may not be obvious to people but perhaps it will help someone.

When running joins in SQL you may encounter a problem if you are trying to pull two columns with the same name. mysqli returns the last in the query when called by name. So to get what you need you can use an alias.

Below I am trying to join a user id with a user role. in the first table (tbl_usr), role is a number and in the second is a  text name (tbl_memrole is a lookup table). If I call them both as role I get the text as it is the last "role" in the query. If I use an alias then I get both as desired as shown below.

<?php
$sql = "SELECT a.uid, a.role AS roleid, b.role, 
            FROM tbl_usr a
            INNER JOIN tbl_memrole b
            ON a.role = b.id
            ";

    if ($result = $mysqli->query($sql)) {
        while($obj = $result->fetch_object()){
            $line.=$obj->uid;
            $line.=$obj->role;
            $line.=$obj->roleid;
        }
    }
    $result->close();
    unset($obj);
    unset($sql);
    unset($query);
    
?>
In this situation I guess I could have just renamed the role column in the first table roleid and that would have taken care of it, but it was a learning experience.
up
34
theyranos at gmail dot com ¶
15 years ago
The cryptic "Couldn't fetch mysqli" error message can mean any number of things, including:

1. You're trying to use a database object that you've already closed (as noted by ceo at l-i-e dot com). Reopen your database connection, or find the call to <?php mysqli_close($db); ?> or <?php $db->close(); ?> and remove it.
2. Your MySQLi object has been serialized and unserialized for some reason. Define a wakeup function to re-create your database connection. http://php.net/__wakeup 
3. Something besides you closed your mysqli connection (in particular, see http://bugs.php.net/bug.php?id=33772)
4. You mixed OOP and functional calls to the database object. (So, you have <?php $db->query() ?> in the same program as <?php mysqli_query($db) ?>).
up
34
petrus.jvr ¶
15 years ago
When calling multiple stored procedures, you can run into the following error: "Commands out of sync; you can't run this command now".
This can happen even when using the close() function on the result object between calls. 
To fix the problem, remember to call the next_result() function on the mysqli object after each stored procedure call. See example below:

<?php
// New Connection
$db = new mysqli('localhost','user','pass','database');

// Check for errors
if(mysqli_connect_errno()){
 echo mysqli_connect_error();
}

// 1st Query
$result = $db->query("call getUsers()");
if($result){
     // Cycle through results
    while ($row = $result->fetch_object()){
        $user_arr[] = $row;
    }
    // Free result set
    $result->close();
    $db->next_result();
}

// 2nd Query
$result = $db->query("call getGroups()");
if($result){
     // Cycle through results
    while ($row = $result->fetch_object()){
        $group_arr[] = $row;
    }
     // Free result set
     $result->close();
     $db->next_result();
}
else echo($db->error);

// Close connection
$db->close();
?>
up
6
xa at sagexa dot com ¶
3 years ago
"In PHP 8.1, the default error handling behavior of the MySQLi extension has changed from silencing errors to throw an Exception on errors. "
This is true even for the procedural use of mysqli, i.e. mysqli_query.
Hence, using if(!mysqli_query($c, $sql)) [...] is pointless.
To disable Exception throwing : mysqli_report(MYSQLI_REPORT_OFF);
up
11
Anonymous ¶
8 years ago
Here is an example of a clean query into a html table

<table>
   <tr>
     <th>First Name</th>
     <th>Last Name</th>
     <th>City</th>
   </tr>
   <?php while ($row = $myquery->fetch_assoc()) { ?>
   <tr>
     <td><?php echo $row["firstname"]; ?></td>
     <td><?php echo $row["lastname"]; ?></td>
     <td><?php echo $row["city"];?></td>
   </tr>
   <?php } ?>
 </table>
up
0
registrations at jdfoxmicro dot com ¶
15 years ago
I like to save the query itself in a log file, so that I don't have to worry about whether the site is live.

For example, I might have a global function:

<?php
function UpdateLog ( $string , $logfile )  {
   $fh = fopen ( $logfile , 'a' );
   $fwrite ( $fh , strftime ('%F %T %z')." ".$string."\n";
   fclose ( $fh );
}
?>

Then in my mysql function error trapper, something like this:

<?php
   $error_msg = "Database error in [page].php / ";
   $error_msg .= mysqli_error ( $link )." / ";
   $error_msg .= $query;
   UpdateLog ( $error_msg , DB_ERROR_LOG_FILE );
?>

I also include the remote IP, user agent, etc., but I left it out of these code samples.  And have it e-mail me when an error is caught, too.

Jeff
up
0
ceo at l-i-e dot com ¶
17 years ago
Translation:
"Couldn't fetch mysqli"

You closed your connection and are trying to use it again.

It has taken me DAYS to figure out what this obscure error message means...
up
-1
Beeners ¶
20 years ago
Stored Procedures.

Use mysqli_query to call a stored procedure that returns a result set. 

Here is a short example:

<?php
$mysqli = new mysqli(DBURI,DBUSER,DBPASS,DBNAME);
if (mysqli_connect_errno()) 
{
  printf("Connection failed: %s\n", mysqli_connect_error());
  exit();
}

$SQL = "CALL my_procedure($something)";
if ( ($result = $mysqli->query($SQL))===false )
{
  printf("Invalid query: %s\nWhole query: %s\n", $mysqli->error, $SQL);
  exit();
}

while ($myrow = $result->fetch_array(MYSQLI_ASSOC))
{
  $aValue[]=$myrow["a"];
  $bValue[]=$myrow["b"];
}
$result->close();
$mysqli->close();
?>
I hope this saves someone some time.