MYSQLI_QUERY |
MySQLi: Requête |
| PHP 5.0+ |
Extension MySQLi |
Syntaxe
|
function mysqli_query($link, $query);
|
|
function mysqli_query($link, $query , $resultmode = MYSQLI_STORE_RESULT);
|
Paramètres
| Nom |
Description |
| $link |
Ce paramètre permet d'indiquer l'identificateur de connexion MySQL a fournit par la fonction mysqli_connect() ou par la fonction mysqli_init() |
| $query |
Ce paramètre permet d'indiquer une chaîne de caractères de la requête SQL a transmettre. |
| $resultmode |
Ce paramètre permet d'indiquer le mode de résultat : |
| MYSQLI_USE_RESULT |
Cette constante permet d'indiquer qu'il faut récupérer une grande quantité de données. |
| MYSQLI_STORE_RESULT |
Cette constante permet d'indiquer un résultat entreposé. Cette valeur la valeur défaut. |
Retour
| Valeur |
Description |
| FALSE |
Cette valeur permet d'indiquer un échec de la fonction. |
| TRUE |
Cette valeur permet d'indiquer que la requête est accepté par la base de données MySQL si la requête était INSERT, UPDATE, DELETE, DROP,... ou une autre requête de retournant pas de résultat. |
| tableau |
Ces valeurs permettent d'indiquer le jeu de résultat pour des requêtes : SELECT, SHOW, DESCRIBE, EXPLAIN,... |
Description
Cette fonction permet d'envoyer une requête de format SQL à une base de données MySQL.
Remarques
- Injection SQL : La fonction retournera tel quel la chaîne de caractères SQL sans transformation. Ainsi, il est du devoir du programmeur de veiller
à ce qu'il n'y pas d'injection SQL provoquer par le caractère «'» ou des échappements.
- Vous recevrez le message d'erreur suivant si la chaîne de caractères de la requête est trop long :
|
got a packet bigger than max_allowed_packet bytes
|
- ou
- Si vous utilisez la constante MYSQLI_USE_RESULT, vous devrez suivre l'appel de la fonction «mysqli_query» par «mysqli_free_result()».
- A partir du PHP version 5.3.0 ou supérieur, le support de requêtes SQL désynchronisé à été ajouté.
Exemple
L'exemple suivant effectuer une connexion à une base de données local et fait un simple test d'une fonction ABS :
- <?php
- $db=mysqli_connect("localhost","gladir_utilisateur","motdepasse","gladir_db");
- if(mysqli_connect_errno()) {
- echo "Échec de connexion à MySQL: " . mysqli_connect_error();
- die();
- }
- mysqli_query($db,"SELECT abs(1);");
- mysqli_close($db);
- ?>
Dernière mise à jour : Mercredi, le 27 novembre 2019
