 |
|
LXXXVI. Extension MySQL améliorée
Introduction
L'extension mysqli vous permet d'accéder aux fonctionnalités fournies par MySQL 4.1 et plus. Plus d'informations sur le serveur de bases de données MySQL peuvent être trouvées sur http://www.mysql.com/
La documentation de MySQL peut être trouvée sur http://dev.mysql.com/doc/.
Une partie de cette documentation provient du manuel officiel MySQL avec la permission de MySQL AB.
Pré-requis
Pour faire fonctionner ces fonctions, vous devez compiler PHP avec le support de l'extension MySQLi.
Note : L'extension MySQLi est conçue pour fonctionner avec la version 4.1.3 ou plus de MySQL. Pour les versions plus anciennes, voyez la documentation de l'extension MySQL.
Installation
Pour installer l'extension mysqli pour PHP, utilisez l'option de configuration --with-mysqli=mysql_config_path où mysql_config_path représente l'endroit où se trouve le programme mysql_config qui accompagne les versions de MySQL supérieures à la 4.1. Désactivez aussi l'extension standard MySQL (qui est activée par défaut) en utilisant aussi l'option de configuration --without-mysql. Si vous voulez installer l'extension standard mysql en même temps que l'extension mysqli, la bibliothèque embarquée libmysql distribuée avec PHP ne peut être utilisée. Utilisez à la place les bibliothèques clientes installées par MySQL avec des versions inférieures à la 4.1. Cela forcera PHP à utiliser les bibliothèques du client installées par MySQL pour éviter les conflits.
Configuration à l'exécution
Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.
Tableau 1. Options de configuration MySQLi
| Nom | Par défaut | Modifiable | Historique |
|---|---|---|---|
| mysqli.max_links | "-1" | PHP_INI_SYSTEM | Disponible depuis PHP 5.0.0. |
| mysqli.default_port | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
| mysqli.default_socket | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
| mysqli.default_host | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
| mysqli.default_user | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
| mysqli.default_pw | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
Voici un éclaircissement sur l'utilisation des directives de configuration.
- mysqli.max_links entier
Le nombre maximal de connexions MySQL par processus, incluant les connexions persistantes.
- mysqli.default_port string
Le numéro par défaut de port TCP à utiliser lors de la connexion au serveur si aucun autre port n'est fourni. S'il n'est pas défini, le port sera obtenu à partir de la variable d'environnement MYSQL_TCP_PORT, l'entrée mysql-tcp dans /etc/services ou la constante de compilation MYSQL_PORT, dans cet ordre. Win32 n'utilisera que la constante MYSQL_PORT.
- mysqli.default_socket string
Le nom par défaut de la socket à utiliser lors des connexions locales au serveur si aucun autre nom n'est fourni.
- mysqli.default_host string
Le serveur par défaut à utiliser lors de la connexion à un serveur si aucun autre hôte n'est fourni. Ne s'applique pas avec le safe mode.
- mysqli.default_user string
Le nom d'utilisateur par défaut à utiliser lors de la connexion à un serveur si aucun autre nom n'est fourni. Ne s'applique pas avec le safe mode.
- mysqli.default_pw string
Le mot de passe par défaut à utiliser lors de la connexion à un serveur si aucun autre mot de passe n'est fourni. Ne s'applique pas avec le safe mode.
Classes pré-définies
mysqli
Représente la connexion entre PHP et le serveur MySQL.
Constructeur
mysqli - construit un nouvel objet mysqli
Méthodes
autocommit - Active ou désactive l'auto-commit
change_user - Change l'utilisateur de la connexion
character_set_name - Retourne le jeu de caractères par défaut de la connexion
close - Ferme une connexion ouverte
commit - Valide la transaction courante
connect - Ouvre une nouvelle connexion au serveur MySQL
debug - Effectue des opérations de débogage
dump_debug_info - Affiche les informations de débogage
get_client_info - Retourne la version du client
get_host_info - Retourne le type de connexion utilisé
get_server_info - Retourne la version du serveur MySQL
get_server_version - Retourne la version du serveur MySQL
init - Initialise un objet mysqli
info - Lit les informations concernant la dernière requête
kill - Tente de terminer un thread serveur
multi_query - Exécute une requête multiple
more_results - Vérifie si d'autres résultats existent après une commande multiple
next_result - Lit le prochain résultat d'une commande multiple
options - Modifie des options
ping - Pinge la connexion au serveur ou se reconnecte si elle est morte
prepare - Prépare une requête SQL
query - Exécute une requête SQL
real_connect - Tente de se connecter au serveur MySQL
escape_string - Protège les caractères spéciaux dans une chaîne
rollback - Annule la transaction courante
select_db - Sélectionne la base de données par défaut
set_charset - Définit le jeu de caractères par défaut du client
ssl_set - Configure les paramètres SSL
stat - Lit le statut courant du système
stmt_init - Initialise une commande pour utilisation avec mysqli_stmt_prepare
store_result - Lit le jeu de résultat de la dernière requête
use_result - Transfère un résultat non-bufferisé
thread_safe - Indique si la sécurité thread est activée
Propriétés
affected_rows - Lit le nombre de lignes affectées par la dernière opération
client_info - Retourne la version cliente de MySQL en tant que chaîne de caractères
client_version - Retourne la version cliente de MySQL en tant qu'entier
errno - Retourne le code d'erreur du dernier appel de fonction
error - Retourne le message d'erreur du dernier appel de fonction
field_count - Retourne le nombre de colonnes de la dernière commande
host_info - Retourne une chaîne décrivant le type de connexion utilisé
info - Lit les informations sur la dernière commande exécutée
insert_id - Retourne le dernier identifiant généré
protocol_version - Retourne la version du protocole MySQL utilisé
sqlstate - Retourne une chaîne contenant le code d'erreur SQLSTATE
thread_id - Retourne l'identifiant de thread de la connexion courante
warning_count - Retourne le nombre d'alertes générées durant l'exécution de la dernière commande SQL
mysqli_stmt
Représente une commande préparée.
Méthodes
bind_param - Associe des variables à une commande préparée
bind_result - Associe des variables à un résultat
close - Termine une commande préparée
data_seek - Place le curseur à une ligne arbitraire dans un jeu de résultat
execute - Exécute une commande préparée
fetch - Lit une ligne de résultat dans des variables associées
free_result - Libère le résultat de la mémoire
result_metadata - Lit un résultat d'une commande préparée
prepare - Prépare une commande SQL
send_long_data - Envoie les données par bloc
reset - annule une commande SQL
store_result - Bufferise complètement le résultat d'une commande préparée
Propriétés
affected_rows - Retourne le nombre de lignes affectées par la dernière commande SQL
errno - Retourne le code d'erreur de la dernière commande
errno - Retourne le message d'erreur de la dernière commande
param_count - Retourne le nombre de paramètres nécessaires pour une commande préparée
sqlstate - Retourne une chaîne contenant le code d'erreur SQLSTATE de la dernière commande
mysqli_result
Représente le résultat retourné par le serveur.
Méthodes
close - Termine le jeu de résultat MySQL
data_seek - Déplace le pointeur de lignes de résultat
fetch_field - Lit les informations de colonnes dans un résultat
fetch_fields - Lit les informations de toutes les colonnes d'un résultat
fetch_field_direct - Lit les informations de colonne
fetch_array - Lit une ligne de résultat dans un tableau associatif ou numérique
fetch_assoc - Lit une ligne de résultat dans un tableau associatif
fetch_object - Lit une ligne de résultat dans un objet
fetch_row - Lit une ligne de résultat dans un tableau numérique
close - Libère le résultat de la mémoire
field_seek - Place le pointeur de résultat à un offset valide
Propriétés
current_field - Retourne la position du pointeur de résultat
field_count - Retourne le nombre de champs du résultat
lengths - Retourne un tableau avec les tailles de colonnes
num_rows - Retourne le nombre de lignes du résultat
Constantes pré-définies
Tableau 2. Constantes MySQLi
| Nom | Description |
|---|---|
| MYSQLI_READ_DEFAULT_GROUP (entier) | Lit les options dans le groupe `my.cnf' ou dans le fichier spécifié par MYSQLI_READ_DEFAULT_FILE |
| MYSQLI_READ_DEFAULT_FILE (entier) | Lit les options dans le fichier spécifié, plutôt que dans my.cnf |
| MYSQLI_OPT_CONNECT_TIMEOUT (entier) | Durée d'expiration de la connexion, en secondes |
| MYSQLI_OPT_LOCAL_INFILE (entier) | Active la commande LOAD LOCAL INFILE |
| MYSQLI_INIT_COMMAND (entier) | Commande à exécuter lors de la connexion au serveur MySQL. Cette commande sera exécutée automatiquement lors de la reconnexion au serveur. |
| MYSQLI_CLIENT_SSL (entier) | Utilise le protocole SSL (chiffrement). Cette option ne doit pas être activée par un programme : elle doit être activée en interne, par la bibliothèque MySQL. |
| MYSQLI_CLIENT_COMPRESS (entier) | Utilise le protocole compressé. |
| MYSQLI_CLIENT_INTERACTIVE (entier) | Permet interactive_timeout secondes (au lieu de wait_timeout secondes) d'inactivité avant de fermer la connexion. La valeur de la variable wait_timeout du client prendra la valeur de interactive_timeout. |
| MYSQLI_CLIENT_IGNORE_SPACE (entier) | Permet les espaces après un nom de fonction. Cela fait de tous les noms de fonctions, des mots réservés. |
| MYSQLI_CLIENT_NO_SCHEMA (entier) | Interdit la syntaxe db_name.tbl_name.col_name. |
| MYSQLI_CLIENT_MULTI_QUERIES (entier) | |
| MYSQLI_STORE_RESULT (entier) | Pour les résultats mis en tampon. |
| MYSQLI_USE_RESULT (entier) | Pour les résultats non-mis en tampon. |
| MYSQLI_ASSOC (entier) | Les colonnes sont retournées dans le tableau, avec leurs noms comme index. |
| MYSQLI_NUM (entier) | Les colonnes sont retournées dans le tableau, avec leurs numéros comme index. |
| MYSQLI_BOTH (entier) | Les colonnes sont retournées dans le tableau, avec leurs noms et leurs numéros comme index. |
| MYSQLI_NOT_NULL_FLAG (entier) | Indique qu'un champ est défini comme NOT NULL |
| MYSQLI_PRI_KEY_FLAG (entier) | Le champ est une clé primaire. |
| MYSQLI_UNIQUE_KEY_FLAG (entier) | Le champ est un index unique. |
| MYSQLI_MULTIPLE_KEY_FLAG (entier) | Le champ fait partie d'un index. |
| MYSQLI_BLOB_FLAG (entier) | Le champ est de type BLOB |
| MYSQLI_UNSIGNED_FLAG (entier) | Le champ est de type UNSIGNED |
| MYSQLI_ZEROFILL_FLAG (entier) | Le champ est de type ZEROFILL |
| MYSQLI_AUTO_INCREMENT_FLAG (entier) | Le champ est de type AUTO_INCREMENT |
| MYSQLI_TIMESTAMP_FLAG (entier) | Le champ est de type TIMESTAMP |
| MYSQLI_SET_FLAG (entier) | Le champ est de type SET |
| MYSQLI_NUM_FLAG (entier) | Le champ est de type NUMERIC |
| MYSQLI_PART_KEY_FLAG (entier) | Le champ fait partie d'un index multiple |
| MYSQLI_GROUP_FLAG (entier) | Le champ fait partie de la clause GROUP BY |
| MYSQLI_TYPE_DECIMAL (entier) | Le champ est de type DECIMAL |
| MYSQLI_TYPE_TINY (entier) | Le champ est de type TINYINT |
| MYSQLI_TYPE_SHORT (entier) | Le champ est de type INT |
| MYSQLI_TYPE_LONG (entier) | Le champ est de type INT |
| MYSQLI_TYPE_FLOAT (entier) | Le champ est de type FLOAT |
| MYSQLI_TYPE_DOUBLE (entier) | Le champ est de type DOUBLE |
| MYSQLI_TYPE_NULL (entier) | Le champ est de type DEFAULT NULL |
| MYSQLI_TYPE_TIMESTAMP (entier) | Le champ est de type TIMESTAMP |
| MYSQLI_TYPE_LONGLONG (entier) | Le champ est de type BIGINT |
| MYSQLI_TYPE_INT24 (entier) | Le champ est de type MEDIUMINT |
| MYSQLI_TYPE_DATE (entier) | Le champ est de type DATE |
| MYSQLI_TYPE_TIME (entier) | Le champ est de type TIME |
| MYSQLI_TYPE_DATETIME (entier) | Le champ est de type DATETIME |
| MYSQLI_TYPE_YEAR (entier) | Le champ est de type YEAR |
| MYSQLI_TYPE_NEWDATE (entier) | Le champ est de type DATE |
| MYSQLI_TYPE_ENUM (entier) | Le champ est de type ENUM |
| MYSQLI_TYPE_SET (entier) | Le champ est de type SET |
| MYSQLI_TYPE_TINY_BLOB (entier) | Le champ est de type TINYBLOB |
| MYSQLI_TYPE_MEDIUM_BLOB (entier) | Le champ est de type MEDIUMBLOB |
| MYSQLI_TYPE_LONG_BLOB (entier) | Le champ est de type LONGBLOB |
| MYSQLI_TYPE_BLOB (entier) | Le champ est de type BLOB |
| MYSQLI_TYPE_VAR_STRING (entier) | Le champ est de type VARCHAR |
| MYSQLI_TYPE_STRING (entier) | Le champ est de type CHAR |
| MYSQLI_TYPE_GEOMETRY (entier) | Le champ est de type GEOMETRY |
| MYSQLI_NEED_DATA (entier) | Il reste des variables à relier |
| MYSQLI_NO_DATA (entier) | Il n'y a plus de variables à relier |
| MYSQLI_DATA_TRUNCATED (integer) | Les données ont été tronquées. Disponible depuis PHP 5.1.0 et MySQL 5.0.5. |
Exemples
Tous les exemples dans la documentation MySQLI utilisent la base de données "world" provenant de MySQL AB. La base de données "world" peut être trouvée ici : http://dev.mysql.com/get/Downloads/Manual/world.sql.gz/from/pick
- Table des matières
- mysqli_affected_rows -- Retourne le nombre de lignes affectées par la dernière opération MySQL
- mysqli_autocommit -- Active ou désactive le mode auto-commit
- mysqli_bind_param -- Alias de mysqli_stmt_bind_param()
- mysqli_bind_result -- Alias de mysqli_stmt_bind_result()
- mysqli_change_user -- Change l'utilisateur de la connexion spécifiée
- mysqli_character_set_name -- Retourne le jeu de caractères courant pour la connexion
- mysqli_client_encoding -- Alias de mysqli_character_set_name()
- mysqli_close -- Ferme une connexion
- mysqli_commit -- Valide la transaction courante
- mysqli_connect_errno -- Retourne le code d'erreur de la connexion MySQL
- mysqli_connect_error -- Retourne le message d'erreur de connexion MySQL
- mysqli_connect -- Ouvre une connexion à un serveur MySQL
- mysqli_data_seek -- Déplace le pointeur interne de résultat
- mysqli_debug -- Effectue des actions de débogage
- mysqli_disable_reads_from_master -- Désactive la lecture depuis le maître
- mysqli_disable_rpl_parse -- Désactive le parseur RPL
- mysqli_dump_debug_info -- Ecrit les informations de débogage dans le log
- mysqli_embedded_connect -- Ouvre une connexion avec un serveur MySQL intégré
- mysqli_enable_reads_from_master -- Active la lecture depuis le maître
- mysqli_enable_rpl_parse -- Active le parseur RPL
- mysqli_errno -- Retourne un code d'erreur pour la dernière commande MySQL
- mysqli_error -- Retourne une chaîne décrivant la dernière erreur
- mysqli_escape_string -- Alias de mysqli_real_escape_string()
- mysqli_execute -- Alias de mysqli_stmt_execute()
- mysqli_fetch_array -- Retourne une ligne de résultat sous la forme d'un tableau associatif, d'un tableau indexé, ou les deux
- mysqli_fetch_assoc -- Récupère une ligne de résultat sous forme de tableau associatif
- mysqli_fetch_field_direct -- Récupère les données métas d'un champ unique
- mysqli_fetch_field -- Retourne le prochain champ dans le jeu de résultats
- mysqli_fetch_fields -- Retourne un tableau d'objets représentant les champs dans le résultat
- mysqli_fetch_lengths -- Retourne la longueur des colonnes de la ligne courante du jeu de résultats
- mysqli_fetch_object -- Retourne la ligne courante d'un jeu de résultat sous forme d'objet
- mysqli_fetch_row -- Récupère une ligne de résultat sous forme de tableau indexé
- mysqli_fetch -- Alias de mysqli_stmt_fetch()
- mysqli_field_count -- Retourne le nombre de colonnes pour la dernière requête
- mysqli_field_seek -- Déplace le pointeur de résultat sur le champ spécifié
- mysqli_field_tell -- Retourne la position du champ courant dans un pointeur de résultat
- mysqli_free_result -- Libère la mémoire associée à un résultat
- mysqli_get_client_info -- Retourne une chaîne contenant la version du client MySQL
- mysqli_get_client_version -- Lit les informations du client MySQL
- mysqli_get_host_info -- Retourne une chaîne contenant le type de connexion utilisée
- mysqli_get_metadata -- Alias de mysqli_stmt_result_metadata()
- mysqli_get_proto_info -- Retourne la version du protocole MySQL utilisé
- mysqli_get_server_info -- Retourne la version du serveur MySQL
- mysqli_get_server_version -- Retourne un entier représentant la version du serveur MySQL
- mysqli_info -- Retourne des informations à propos de la dernière requête exécutée
- mysqli_init -- Initialise MySQLi et retourne une ressource à utiliser avec mysqli_real_connect()
- mysqli_insert_id -- Retourne l'identifiant automatiquement généré par la dernière requête
- mysqli_kill -- Demande au serveur de terminer un thread MySQL
- mysqli_master_query -- Force l'exécution d'une requête sur le maître dans une configuration maître/esclave (master/slave)
- mysqli_more_results -- Vérifie s'il y a d'autres jeux de résultats MySQL disponibles
- mysqli_multi_query -- Exécute une requête MySQL multiple
- mysqli_next_result -- Prépare le prochain résultat d'une requête multiple
- mysqli_num_fields -- Retourne le nombre de champs dans un résultat
- mysqli_num_rows -- Retourne le nombre de lignes dans un résultat
- mysqli_options -- Définit les options
- mysqli_param_count -- Alias de mysqli_stmt_param_count()
- mysqli_ping -- Ping la connexion au serveur et reconnecte si elle n'existe plus
- mysqli_prepare -- Prépare une requête SQL pour l'exécution
- mysqli_query -- Exécute une requête sur la base de données
- mysqli_real_connect -- Ouvre une connexion à un serveur MySQL
- mysqli_real_escape_string -- Protège les caractères spéciaux d'une chaîne pour l'utiliser dans une requête SQL, en prenant en compte le jeu de caractères courant de la connexion
- mysqli_real_query -- Exécute une requête SQL
- mysqli_report -- Active ou désactive les fonctions de rapport interne
- mysqli_rollback -- Annule la transaction courante
- mysqli_rpl_parse_enabled -- Vérifie si le parseur RPL est activé
- mysqli_rpl_probe -- Sonde le RPL
- mysqli_rpl_query_type -- Retourne le type de requête RPL
- mysqli_select_db -- Sélectionne une base de données par défaut pour les requêtes
- mysqli_send_long_data -- Alias de mysqli_stmt_send_long_data()
- mysqli_send_query -- Envoie la requête et retourne
- mysqli_server_end -- Eteint le serveur embarqué
- mysqli_server_init -- Initialise le serveur MySQL intégré
- mysqli_set_charset -- Définit le jeu de caractères par défaut du client
- mysqli_set_opt -- Alias de mysqli_options()
- mysqli_sqlstate -- Retourne l'erreur SQLSTATE de la dernière opération MySQL
- mysqli_ssl_set -- Utilisée pour établir une connexion sécurisée avec SSL
- mysqli_stat -- Obtient le statut courant du système
- mysqli_stmt_affected_rows -- Retourne le nombre total de lignes modifiées, effacées ou insérées par la dernière requête
- mysqli_stmt_bind_param -- Lie des variables à une requête MySQL
- mysqli_stmt_bind_result -- Lie des variables à un jeu de résultats
- mysqli_stmt_close -- Ferme une requête préparée
- mysqli_stmt_data_seek -- Déplace le pointeur de résultat MySQL
- mysqli_stmt_errno -- Retourne un code erreur pour la dernière requête
- mysqli_stmt_error -- Retourne une description de la dernière erreur de traitement
- mysqli_stmt_execute -- Exécute une requête préparée
- mysqli_stmt_fetch -- Lit des résultats depuis une requête MySQL préparée dans des variables liées
- mysqli_stmt_free_result -- Libère le résultat MySQL de la mémoire
- mysqli_stmt_init -- Initialise une commande MySQL
- mysqli_stmt_num_rows -- Retourne le nombre de lignes d'un résultat MySQL
- mysqli_stmt_param_count -- Retourne le nombre de paramètres d'une commande MySQL
- mysqli_stmt_prepare -- Prépare une requête SQL pour l'exécution
- mysqli_stmt_reset -- Annule une requête préparée
- mysqli_stmt_result_metadata -- Retourne les méta-données de préparation de requête MySQL
- mysqli_stmt_send_long_data -- Envoie des données MySQL par paquets
- mysqli_stmt_sqlstate -- Retourne le code SQLSTATE de la dernière opération MySQL
- mysqli_stmt_store_result -- Récupère un jeu de résultats depuis une requête préparée
- mysqli_store_result -- Transfère un jeu de résultats à partir de la dernière requête
- mysqli_thread_id -- Retourne l'identifiant du thread pour la connexion courante
- mysqli_thread_safe -- Indique si le thread safety est donné ou non
- mysqli_use_result -- Initialise la récupération d'un jeu de résultats
- mysqli_warning_count -- Retourne le nombre d'avertissements générés par la dernière requête
| Précédent | Sommaire | Suivant |
| PDO_MYSQL DSN | Niveau supérieur | mysqli_affected_rows |
Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:59