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.

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.

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.

Le comportement de ces fonctions est affecté par la configuration dans le fichier “php.ini”.

Tableau 1. Options de configuration MySQLi

Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Annexe G.

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

“mysqli.default_user” string

“mysqli.default_pw” string

Représente la connexion entre PHP et le serveur MySQL.

• mysqli - construit un nouvel objet mysqli

• 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
• thread_safe - Indique si la sécurité du thread est activée
• use_result - Transfère un résultat non-bufferisé

• 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é
• server_info - Retourne une chaîne de caractères qui représente le numéro de version du serveur
• server_version - Retourne le numéro de version du serveur en tant qu’entier
• 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

Représente une commande préparée.

• 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
• prepare - Prépare une commande SQL
• reset - annule une commande SQL
• result_metadata - Lit un résultat d’une commande préparée
• send_long_data - Envoie les données par bloc
• store_result - Bufferise complètement le résultat d’une commande préparée

• 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
• error - Retourne le message d’erreur de la dernière commande
• field_count - Retourne le nombre de colonnes dans un jeu de résultats
• id - Retourne l’identifiant de la requête
• insert_id - Retourne la valeur générée pour une colonne AUTO_INCREMENT par la requête préparée
• num_rows - Retourne le nombre de lignes dans le jeu de résultats
• 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

Représente le résultat retourné par le serveur.

• close - Termine le jeu de résultat MySQL
• data_seek - Déplace le pointeur de lignes de résultat
• 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_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_object - Lit une ligne de résultat dans un objet
• fetch_row - Lit une ligne de résultat dans un tableau numérique
• field_seek - Place le pointeur de résultat à un offset valide
• free_result - Libère le résultat de la mémoire

• 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
• type - Retourne “MYSQLI_STORE_RESULT” ou “MYSQLI_USE_RESULT”

Tableau 2. Constantes MySQLi

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 MySQLmysqli_autocommit – Active ou désactive le mode auto-commitmysqli_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éemysqli_character_set_name – Retourne le jeu de caractères courant pour la connexionmysqli_client_encoding – Alias de mysqli_character_set_name()
mysqli_close – Ferme une connexionmysqli_commit – Valide la transaction courantemysqli_connect_errno – Retourne le code d’erreur de la connexion MySQLmysqli_connect_error – Retourne le message d’erreur de connexion MySQLmysqli_connect – Ouvre une connexion à un serveur MySQLmysqli_data_seek – Déplace le pointeur interne de résultatmysqli_debug – Effectue des actions de débogagemysqli_disable_reads_from_master – Désactive la lecture depuis le maîtremysqli_disable_rpl_parse – Désactive le parseur RPLmysqli_dump_debug_info – Écrit les informations de débogage dans les logsmysqli_embedded_server_end – mysqli_embedded_server_start – mysqli_enable_reads_from_master – Active la lecture depuis le maîtremysqli_enable_rpl_parse – Active le parseur RPLmysqli_errno – Retourne un code d’erreur pour la dernière commande MySQLmysqli_error – Retourne une chaîne décrivant la dernière erreurmysqli_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 deuxmysqli_fetch_assoc – Récupère une ligne de résultat sous forme de tableau associatifmysqli_fetch_field_direct – Récupère les données métas d’un champ uniquemysqli_fetch_field – Retourne le prochain champs dans le jeu de résultatsmysqli_fetch_fields – Retourne un tableau d’objets représentant les champs dans le résultatmysqli_fetch_lengths – Retourne la longueur des colonnes de la ligne courante du jeu de résultatsmysqli_fetch_object – Retourne la ligne courante d’un jeu de résultat sous forme d’objetmysqli_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êtemysqli_field_seek – Déplace le pointeur de résultat sur le champs spécifiémysqli_field_tell – Retourne la position du champs courant dans un pointeur de résultatmysqli_free_result – Libère la mémoire associée à un résultatmysqli_get_charset – Retourne un objet contenant le jeu de caractèresmysqli_get_client_info – Retourne une chaîne contenant la version du client MySQLmysqli_get_client_version – Lit les informations du client MySQLmysqli_get_host_info – Retourne une chaîne contenant le type de connexion utiliséemysqli_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 MySQLmysqli_get_server_version – Retourne un entier représentant la version du serveur MySQLmysqli_get_warnings – mysqli_info – Retourne des informations à propos de la dernière requête exécutéemysqli_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êtemysqli_kill – Demande au serveur de terminer un thread MySQLmysqli_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 disponiblesmysqli_multi_query – Exécute une requête MySQL multiplemysqli_next_result – Prépare le prochain résultat d’une requête multiplemysqli_num_fields – Retourne le nombre de champs dans un résultatmysqli_num_rows – Retourne le nombre de lignes dans un résultatmysqli_options – Définit les optionsmysqli_param_count – Alias de mysqli_stmt_param_count()
mysqli_ping – Ping la connexion au serveur et reconnecte si elle n’existe plusmysqli_prepare – Prépare une requête SQL pour l’exécutionmysqli_query – Exécute une requête sur la base de donnéesmysqli_real_connect – Ouvre une connexion à un serveur MySQLmysqli_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 connexionmysqli_real_query – Exécute une requête SQLmysqli_report – Active ou désactive les fonctions de rapport internemysqli_rollback – Annule la transaction courantemysqli_rpl_parse_enabled – Vérifie si l’analyseur RPL est activémysqli_rpl_probe – Sonde le RPLmysqli_rpl_query_type – Retourne le type de requête RPLmysqli_select_db – Sélectionne une base de données par défaut pour les requêtesmysqli_send_long_data – Alias de mysqli_stmt_send_long_data()
mysqli_send_query – Envoie la requête et retournemysqli_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 clientmysqli_set_local_infile_default – Rétablit le gestionnaire par défaut pour la commande LOAD LOCAL INFILEmysqli_set_local_infile_handler – Définit une fonction de callback pour la commande LOAD DATA LOCAL INFILEmysqli_set_opt – Alias de mysqli_options()
mysqli_slave_query – Force l’exécution de la requête sur un serveur esclave pour une configuration maître/esclavemysqli_sqlstate – Retourne l’erreur SQLSTATE de la dernière opération MySQLmysqli_ssl_set – Utilisée pour établir une connexion sécurisée avec SSLmysqli_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_attr_get – mysqli_stmt_attr_set – mysqli_stmt_bind_param – Lie des variables à une requête MySQLmysqli_stmt_bind_result – Lie des variables à un jeu de résultatsmysqli_stmt_close – Ferme une requête préparéemysqli_stmt_data_seek – Déplace le pointeur de résultat MySQLmysqli_stmt_errno – Retourne un code erreur pour la dernière requêtemysqli_stmt_error – Retourne une description de la dernière erreur de traitementmysqli_stmt_execute – Exécute une requête préparéemysqli_stmt_fetch –  Lit des résultats depuis une requête MySQL préparée dans des variables liées mysqli_stmt_field_count – Retourne le nombre de champs présent dans la requête donnéemysqli_stmt_free_result – Libère le résultat MySQL de la mémoiremysqli_stmt_get_warnings – mysqli_stmt_init –  Initialise une commande MySQL mysqli_stmt_insert_id – Récupère l’ID généré par la dernière requête INSERTmysqli_stmt_num_rows – Retourne le nombre de lignes d’un résultat MySQLmysqli_stmt_param_count – Retourne le nombre de paramètres d’une commande MySQLmysqli_stmt_prepare –  Prépare une requête SQL pour l’exécution mysqli_stmt_reset – Annule une requête préparéemysqli_stmt_result_metadata – Retourne les méta-données de préparation de requête MySQLmysqli_stmt_send_long_data – Envoie des données MySQL par paquetsmysqli_stmt_sqlstate – Retourne le code SQLSTATE de la dernière opération MySQLmysqli_stmt_store_result – Récupère un jeu de résultats depuis une requête préparéemysqli_store_result – Transfère un jeu de résultats à partir de la dernière requêtemysqli_thread_id – Retourne l’identifiant du thread pour la connexion courantemysqli_thread_safe –  Indique si le thread safety est donné ou non mysqli_use_result – Initialise la récupération d’un jeu de résultatsmysqli_warning_count –  Retourne le nombre d’avertissements générés par la dernière requête