mysqli::query
mysqli_query
(PHP 5, PHP 7)
mysqli::query -- mysqli_query — Exécute une requête sur la base de données
Description
Style orienté objet
Style procédural
Exécute une requête sur la base de données.
Pour les requêtes non-DML (qui n'est pas un INSERT, un UPDATE ou un DELETE), cette fonction est similaire à appeler à appeler mysqli_real_query() suivie de mysqli_use_result() ou mysqli_store_result().
Note:
Si vous passez une requête à mysqli_query() qui est plus longue que max_allowed_packet, les codes d'erreur en retour seront différents selon si vous utilisez 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
-
link
-
Seulement en style procédural : 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.
Les données contenues dans la requête doivent être échappées.
-
resultmode
-
Soit la constante
MYSQLI_USE_RESULT
, soit la constanteMYSQLI_STORE_RESULT
, suivant le comportement désiré. Par défaut, la constanteMYSQLI_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().Avec la constante
MYSQLI_ASYNC
(disponible avec mysqlnd), il est possible de faire des requêtes asynchrone. mysqli_poll() est alors utilisé pour lire les résultats de ce type de requêtes.
Valeurs de retour
Retourne FALSE
en cas d'échec. Pour des requêtes SELECT, SHOW,
DESCRIBE ou EXPLAIN réussies,
mysqli_query() retournera un objet mysqli_result.
Pour les autres types de requêtes ayant réussi,
mysqli_query() retournera TRUE
.
Exemples
Exemple #1 Exemple avec mysqli::query()
Style orienté objet
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */
if ($mysqli->connect_errno) {
printf("Échec de la connexion : %s\n", $mysqli->connect_error);
exit();
}
/* "Create table" ne retournera aucun jeu de résultats */
if ($mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) {
printf("Table myCity créée avec succès.\n");
}
/* Requête "Select" retourne un jeu de résultats */
if ($result = $mysqli->query("SELECT Name FROM City LIMIT 10")) {
printf("Select a retourné %d lignes.\n", $result->num_rows);
/* Libération du jeu de résultats */
$result->close();
}
/* Si nous avons à récupérer beaucoup de données, nous utilisons MYSQLI_USE_RESULT */
if ($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 retourneront un 'out of sync'
*/
if (!$mysqli->query("SET @a:='this will not work'")) {
printf("Erreur : %s\n", $mysqli->error);
}
$result->close();
}
$mysqli->close();
?>
Style procédural
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
/* "Create table" ne retournera aucun jeu de résultats */
if (mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) {
printf("Table myCity créée avec succès.\n");
}
/* Requête "Select" retourne un jeu de résultats */
if ($result = mysqli_query($link, "SELECT Name FROM City LIMIT 10")) {
printf("Select a retourné %d lignes.\n", mysqli_num_rows($result));
/* Libération du jeu de résultats */
mysqli_free_result($result);
}
/* Si nous avons à récupérer beaucoup de données, nous utilisons MYSQLI_USE_RESULT */
if ($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 retourneront un 'out of sync'
*/
if (!mysqli_query($link, "SET @a:='this will not work'")) {
printf("Erreur : %s\n", mysqli_error($link));
}
mysqli_free_result($result);
}
mysqli_close($link);
?>
Les exemples ci-dessus vont 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_real_query() - Exécute une requête SQL
- mysqli_multi_query() - Exécute une requête MySQL multiple
- mysqli_free_result() - Libère la mémoire associée à un résultat
Version en cache
05/11/2024 09:23:22 Cette version de la page est en cache (à la date du 05/11/2024 09:23:22) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-mysqli.query.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.