From f0a735bea3151f8d991245655230dbe22bb069af Mon Sep 17 00:00:00 2001 From: lacatoire Date: Tue, 25 Aug 2026 09:48:18 +0200 Subject: [PATCH] [Sync-En] MySQLi: remove notes/summary, clean up functions, document wait-timeout change MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Remove mysqli.notes and mysqli.summary (notes.xml, summary.xml deleted) - Remove &reference.mysqli.notes; and &reference.mysqli.summary; from book.xml - Remove link to mysqli.summary from quickstart.xml - Add note about MYSQL_TYPE_GEOMETRY memory differences to overview.xml - Delete mysqli-connect.xml and mysqli-report.xml (obsolete alias pages) - Rename functions/mysqli-escape-string.xml -> mysqli/escape-string.xml - Rename functions/mysqli-set-opt.xml -> mysqli/set-opt.xml - Update reference.xml title: 'Fonctions mysqli obsolètes et alias' -> 'Fonctions MySQLi' - query.xml: add changelog for wait-timeout error code change 2006->4031 (8.4.0) --- reference/mysqli/book.xml | 4 +- reference/mysqli/functions/mysqli-connect.xml | 46 -- reference/mysqli/functions/mysqli-report.xml | 40 - .../escape-string.xml} | 7 +- reference/mysqli/mysqli/query.xml | 29 +- .../mysqli-set-opt.xml => mysqli/set-opt.xml} | 7 +- reference/mysqli/notes.xml | 57 -- reference/mysqli/overview.xml | 16 +- reference/mysqli/quickstart.xml | 3 +- reference/mysqli/reference.xml | 7 +- reference/mysqli/summary.xml | 733 ------------------ 11 files changed, 51 insertions(+), 898 deletions(-) delete mode 100644 reference/mysqli/functions/mysqli-connect.xml delete mode 100644 reference/mysqli/functions/mysqli-report.xml rename reference/mysqli/{functions/mysqli-escape-string.xml => mysqli/escape-string.xml} (82%) rename reference/mysqli/{functions/mysqli-set-opt.xml => mysqli/set-opt.xml} (81%) delete mode 100644 reference/mysqli/notes.xml delete mode 100755 reference/mysqli/summary.xml diff --git a/reference/mysqli/book.xml b/reference/mysqli/book.xml index 6234f9c101..7b5932beb5 100644 --- a/reference/mysqli/book.xml +++ b/reference/mysqli/book.xml @@ -1,5 +1,5 @@ - + @@ -49,8 +49,6 @@ &reference.mysqli.setup; &reference.mysqli.persistconns; &reference.mysqli.constants; - &reference.mysqli.notes; - &reference.mysqli.summary; &reference.mysqli.mysqli; &reference.mysqli.mysqli-stmt; &reference.mysqli.mysqli-result; diff --git a/reference/mysqli/functions/mysqli-connect.xml b/reference/mysqli/functions/mysqli-connect.xml deleted file mode 100644 index b46cf40bd6..0000000000 --- a/reference/mysqli/functions/mysqli-connect.xml +++ /dev/null @@ -1,46 +0,0 @@ - - - - - - - mysqli_connect - &Alias; mysqli::__construct - - - - &reftitle.description; - - &info.function.alias; mysqli::__construct - - - - Si le mode d'exception mysqli n'est pas activé et qu'une connexion échoue, - alors mysqli_connect retourne &false; au lieu d'un objet. - La fonction mysqli_connect_error peut être utilisée pour - récupérer l'erreur de connexion. - - - - - - diff --git a/reference/mysqli/functions/mysqli-report.xml b/reference/mysqli/functions/mysqli-report.xml deleted file mode 100644 index 09997226b6..0000000000 --- a/reference/mysqli/functions/mysqli-report.xml +++ /dev/null @@ -1,40 +0,0 @@ - - - - - - - - mysqli_report - &Alias; mysqli_driver->report_mode - - - - &reftitle.description; - - &info.function.alias; mysqli_driver->report_mode - - - - - - - diff --git a/reference/mysqli/functions/mysqli-escape-string.xml b/reference/mysqli/mysqli/escape-string.xml similarity index 82% rename from reference/mysqli/functions/mysqli-escape-string.xml rename to reference/mysqli/mysqli/escape-string.xml index 297feb77a6..a7b10ff890 100644 --- a/reference/mysqli/functions/mysqli-escape-string.xml +++ b/reference/mysqli/mysqli/escape-string.xml @@ -1,9 +1,6 @@ - - - - - + + mysqli::escape_string mysqli_escape_string diff --git a/reference/mysqli/mysqli/query.xml b/reference/mysqli/mysqli/query.xml index 1eae43c2ca..3e4fb80d24 100644 --- a/reference/mysqli/mysqli/query.xml +++ b/reference/mysqli/mysqli/query.xml @@ -1,5 +1,5 @@ - + @@ -128,6 +128,33 @@ &mysqli.conditionalexception; + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.4.0 + + Lors d'une connexion à MySQL 8.0.24 ou ultérieur, le code d'erreur signalé + pour un délai d'attente du serveur est désormais 4031 + (ER_CLIENT_INTERACTION_TIMEOUT) au lieu de + 2006 (CR_SERVER_GONE_ERROR). + + + + + + + + &reftitle.examples; diff --git a/reference/mysqli/functions/mysqli-set-opt.xml b/reference/mysqli/mysqli/set-opt.xml similarity index 81% rename from reference/mysqli/functions/mysqli-set-opt.xml rename to reference/mysqli/mysqli/set-opt.xml index d8d4da13ca..4c9b7cb6a7 100644 --- a/reference/mysqli/functions/mysqli-set-opt.xml +++ b/reference/mysqli/mysqli/set-opt.xml @@ -1,9 +1,6 @@ - - - - - + + mysqli::set_opt mysqli_set_opt diff --git a/reference/mysqli/notes.xml b/reference/mysqli/notes.xml deleted file mode 100644 index ea390aaf8e..0000000000 --- a/reference/mysqli/notes.xml +++ /dev/null @@ -1,57 +0,0 @@ - - - - - - - Notes - - Quelques notes sur l'implémentation : - - - - - Le support de MYSQL_TYPE_GEOMETRY - a été ajouté à l'extension MySQLI en PHP 5.3. - - - - - Il est à noter qu'il y a des différences internes d'implémentations - entre libmysqlclient et mysqlnd - pour gérer les colonnes de type MYSQL_TYPE_GEOMETRY. - D'un point de vue général, mysqlnd alloue beaucoup - moins de mémoire. Par exemple, s'il y a une colonne de type - POINT dans le jeu de résultats, - libmysqlclient allouera environ 4GB de RAM - alors qu'il ne faut que 50 octets pour gérer une colonne de type - POINT en mémoire. L'allocation mémoire est encore - plus faible que 50 octets lors de l'utilisation de - mysqlnd. - - - - - - - - diff --git a/reference/mysqli/overview.xml b/reference/mysqli/overview.xml index 017140b633..cb8ccb3840 100644 --- a/reference/mysqli/overview.xml +++ b/reference/mysqli/overview.xml @@ -1,5 +1,5 @@ - + @@ -321,6 +321,20 @@ --> + + + Il existe différentes implémentations internes au sein de + libmysqlclient et mysqlnd pour gérer + les colonnes de type MYSQL_TYPE_GEOMETRY. En règle générale, + mysqlnd alloue beaucoup moins de mémoire. Par exemple, si + un jeu de résultats contient une colonne POINT, + libmysqlclient peut pré-allouer jusqu'à 4 Go de RAM alors + que moins de 50 octets sont nécessaires pour stocker une colonne + POINT en mémoire. L'allocation mémoire est bien inférieure, + moins de 50 octets, avec mysqlnd. + + + Comparaison des fonctionnalités diff --git a/reference/mysqli/quickstart.xml b/reference/mysqli/quickstart.xml index 2a357bdf46..17bb90e499 100644 --- a/reference/mysqli/quickstart.xml +++ b/reference/mysqli/quickstart.xml @@ -1,5 +1,5 @@ - + Guide de démarrage rapide @@ -146,7 +146,6 @@ Possible but bad style. $mysqli::connect_error $mysqli::errno $mysqli::error - Le résumé des fonctions de l'extension MySQLi diff --git a/reference/mysqli/reference.xml b/reference/mysqli/reference.xml index 38081f02d0..0707ba5f3b 100644 --- a/reference/mysqli/reference.xml +++ b/reference/mysqli/reference.xml @@ -1,10 +1,7 @@ - - - - + - &Functions; mysqli obsolètes et alias + &Functions; MySQLi &reference.mysqli.entities.functions; diff --git a/reference/mysqli/summary.xml b/reference/mysqli/summary.xml deleted file mode 100755 index e02e7fe4ee..0000000000 --- a/reference/mysqli/summary.xml +++ /dev/null @@ -1,733 +0,0 @@ - - - - - Le sommaire des fonctions de l'extension MySQLi - - - Sommaire des méthodes <classname>mysqli</classname> - - - - Classe mysqli - - - Interface POO - Interface procédurale - Alias (Ne plus utiliser) - Description - - - - - &Properties; - - - $mysqli::affected_rows - mysqli_affected_rows - N/A - Retourne le nombre de lignes affectées par la dernière opération MySQL - - - $mysqli::client_info - mysqli_get_client_info - N/A - Retourne la version du client MySQL sous la forme d'une &string; - - - $mysqli::client_version - mysqli_get_client_version - N/A - Retourne l'information sur la version du client MySQL sous la forme d'un entier - - - $mysqli::connect_errno - mysqli_connect_errno - N/A - Retourne le code d'erreur de la connexion MySQL - - - $mysqli::connect_error - mysqli_connect_error - N/A - Retourne le message d'erreur de la connexion MySQL - - - $mysqli::errno - mysqli_errno - N/A - Retourne le code d'erreur de connexion MySQL - - - $mysqli::error - mysqli_error - N/A - Retourne le message d'erreur de connexion MySQL - - - $mysqli::field_count - mysqli_field_count - N/A - Retourne le nombre de colonnes pour la dernière requête - - - $mysqli::host_info - mysqli_get_host_info - N/A - Retourne une chaîne contenant le type de connexion utilisée - - - $mysqli::protocol_version - mysqli_get_proto_info - N/A - Retourne la version du protocole MySQL utilisé - - - $mysqli::server_info - mysqli_get_server_info - N/A - Retourne la version du serveur MySQL - - - $mysqli::server_version - mysqli_get_server_version - N/A - Retourne un entier représentant la version du serveur MySQL - - - $mysqli::info - mysqli_info - N/A - Retourne des informations à propos de la dernière requête exécutée - - - $mysqli::insert_id - mysqli_insert_id - N/A - Retourne l'identifiant automatiquement généré par la dernière requête - - - $mysqli::sqlstate - mysqli_sqlstate - N/A - Retourne l'erreur SQLSTATE de la dernière opération MySQL - - - $mysqli::warning_count - mysqli_warning_count - N/A - Retourne le nombre d'avertissements générés par la dernière requête - - - &Methods; - - - mysqli::autocommit - mysqli_autocommit - N/A - Active ou désactive le mode auto-commit - - - mysqli::change_user - mysqli_change_user - N/A - Change l'utilisateur de la connexion spécifiée - - - mysqli::character_set_name - mysqli_character_set_name - N/A - Retourne le jeu de caractères courant pour la connexion - - - mysqli::close - mysqli_close - N/A - Ferme une connexion - - - mysqli::commit - mysqli_commit - N/A - Valide la transaction courante - - - mysqli::__construct - mysqli_connect - N/A - Ouvre une connexion à un serveur MySQL - - - mysqli::debug - mysqli_debug - N/A - Effectue des actions de débogage - - - mysqli::dump_debug_info - mysqli_dump_debug_info - N/A - Écrit les informations de débogage dans les logs - - - mysqli::get_charset - mysqli_get_charset - N/A - Retourne un objet représentant le jeu de caractères - - - mysqli::get_connection_stats - mysqli_get_connection_stats - N/A - Retourne des statistiques sur la connexion du client. &mysqli.available.mysqlnd; - - - mysqli::get_client_info - mysqli_get_client_info - N/A - Retourne une chaîne contenant la version du client MySQL - - - N/A - mysqli_get_client_stats - N/A - Retourne les statistiques du client MySQL. &mysqli.available.mysqlnd; - - - mysqli::get_server_info - mysqli_get_server_info - N/A - Retourne une chaîne représentant la version du serveur MySQL sur laquelle l'extension MySQLi est connectée - - - mysqli::get_warnings - mysqli_get_warnings - N/A - Récupère le résultat de SHOW WARNINGS - - - mysqli::init - mysqli_init - N/A - Initialise MySQLi et retourne un objet à utiliser avec mysqli_real_connect() - - - mysqli::kill - mysqli_kill - N/A - Demande au serveur de terminer un thread MySQL - - - mysqli::more_results - mysqli_more_results - N/A - Vérifie s'il y a d'autres jeux de résultats MySQL disponibles - - - mysqli::multi_query - mysqli_multi_query - N/A - Exécute une requête MySQL multiple - - - mysqli::next_result - mysqli_next_result - N/A - Prépare le prochain résultat d'une requête multiple - - - mysqli::options - mysqli_options - mysqli_set_opt - Définit les options - - - mysqli::ping - mysqli_ping - N/A - Ping la connexion au serveur et reconnecte si elle n'existe plus - - - mysqli::prepare - mysqli_prepare - N/A - Prépare une requête SQL pour l'exécution - - - mysqli::query - mysqli_query - N/A - Exécute une requête sur la base de données - - - mysqli::real_connect - mysqli_real_connect - N/A - Ouvre une connexion à un serveur MySQL - - - mysqli::real_escape_string, - mysqli::escape_string - mysqli_real_escape_string - mysqli_escape_string - Protège les caractères spéciaux d'une chaîne pour l'utiliser dans une requête - - - mysqli::real_query - mysqli_real_query - N/A - Exécute une requête SQL - - - mysqli::refresh - mysqli_refresh - N/A - Ré-initialise les tables ou les caches, ou réinitialise les - informations de réplication du serveur - - - mysqli::rollback - mysqli_rollback - N/A - Annule la transaction courante - - - mysqli::select_db - mysqli_select_db - N/A - Sélectionne une base de données par défaut pour les requêtes - - - mysqli::set_charset - mysqli_set_charset - N/A - Définit le jeu de caractères par défaut du client - - - mysqli::ssl_set - mysqli_ssl_set - N/A - Utilisée pour établir une connexion sécurisée avec SSL - - - mysqli::stat - mysqli_stat - N/A - Obtient le statut courant du système - - - mysqli::stmt_init - mysqli_stmt_init - N/A - Initialise une commande MySQL - - - mysqli::store_result - mysqli_store_result - N/A - Transfère un jeu de résultats à partir de la dernière requête - - - mysqli::thread_id - mysqli_thread_id - N/A - Retourne l'identifiant du thread pour la connexion courante - - - mysqli::thread_safe - mysqli_thread_safe - N/A - Indique si le support des threads est activé ou pas - - - mysqli::use_result - mysqli_use_result - N/A - Initialise la récupération d'un jeu de résultats - - - -
- - - Résumé des méthodes <classname>mysqli_stmt</classname> - - - - MySQL_STMT - - - Interface POO - Interface procédurale - Alias (Ne plus utiliser) - Description - - - - - &Properties; - - - $mysqli_stmt::affected_rows - mysqli_stmt_affected_rows - N/A - Le nombre total de lignes modifiées, effacées ou insérées par la dernière - - - $mysqli_stmt::errno - mysqli_stmt_errno - N/A - Le code erreur de la dernière requête - - - $mysqli_stmt::error - mysqli_stmt_error - N/A - Le message d'erreur de la dernière requête - - - $mysqli_stmt::field_count - mysqli_stmt_field_count - N/A - Le nombre de champs présents dans la requête - - - $mysqli_stmt::insert_id - mysqli_stmt_insert_id - N/A - L'ID généré par la dernière requête INSERT - - - $mysqli_stmt::num_rows - mysqli_stmt_num_rows - N/A - Le nombre de lignes du jeu de résultats de la requête - - - $mysqli_stmt::param_count - mysqli_stmt_param_count - N/A - Le nombre de paramètres de la requête - - - $mysqli_stmt::sqlstate - mysqli_stmt_sqlstate - N/A - Le code SQLSTATE de l'opération précédente - - - &Methods; - - - mysqli_stmt::attr_get - mysqli_stmt_attr_get - N/A - Récupère la valeur courante d'un attribut de la requête - - - mysqli_stmt::attr_set - mysqli_stmt_attr_set - N/A - Modifie le comportement d'une requête préparée - - - mysqli_stmt::bind_param - mysqli_stmt_bind_param - N/A - Lie des variables à une requête MySQL - - - mysqli_stmt::bind_result - mysqli_stmt_bind_result - N/A - Lie des variables à un jeu de résultats - - - mysqli_stmt::close - mysqli_stmt_close - N/A - Termine une requête préparée - - - mysqli_stmt::data_seek - mysqli_stmt_data_seek - N/A - Déplace le pointeur de résultat - - - mysqli_stmt::execute - mysqli_stmt_execute - mysqli_execute - Exécute une requête préparée - - - mysqli_stmt::fetch - mysqli_stmt_fetch - N/A - Lit des résultats depuis une requête MySQL préparée dans des variables liées - - - mysqli_stmt::free_result - mysqli_stmt_free_result - N/A - Libère le résultat MySQL de la mémoire - - - mysqli_stmt::get_result - mysqli_stmt_get_result - N/A - Récupère le jeu de résultats depuis une requête préparée. &mysqli.available.mysqlnd; - - - mysqli_stmt::get_warnings - mysqli_stmt_get_warnings - N/A - Non documenté - - - mysqli_stmt::more_results - mysqli_stmt_more_results - N/A - Vérifie s'il y a plus de résultats de requête à partir d'une requête multiple - - - mysqli_stmt::next_result - mysqli_stmt_next_result - N/A - Lit le résultat suivant à partir d'une requête multiple - - - mysqli_stmt::num_rows - mysqli_stmt_num_rows - N/A - Voir aussi la propriété $mysqli_stmt->num_rows - - - mysqli_stmt::prepare - mysqli_stmt_prepare - N/A - Prépare une requête SQL pour l'exécution - - - mysqli_stmt::reset - mysqli_stmt_reset - N/A - Annule une requête préparée - - - mysqli_stmt::result_metadata - mysqli_stmt_result_metadata - N/A - Retourne les métadonnées de préparation de requête MySQL - - - mysqli_stmt::send_long_data - mysqli_stmt_send_long_data - N/A - Envoie des données MySQL par paquets - - - mysqli_stmt::store_result - mysqli_stmt_store_result - N/A - Stocke un jeu de résultats depuis une requête préparée - - - -
- - - Résumé des méthodes <classname>mysqli_result</classname> - - - - mysqli_result - - - Interface POO - Interface procédurale - Alias (Ne plus utiliser) - Description - - - - - &Properties; - - - $mysqli_result::current_field - mysqli_field_tell - N/A - La position courante d'un champ dans un pointeur de résultat - - - $mysqli_result::field_count - mysqli_num_fields - N/A - Le nombre de champs dans un résultat - - - $mysqli_result::lengths - mysqli_fetch_lengths - N/A - Les tailles des champs dans un résultat - - - $mysqli_result::num_rows - mysqli_num_rows - N/A - Le nombre de lignes dans un résultat - - - &Methods; - - - mysqli_result::data_seek - mysqli_data_seek - N/A - Déplace le pointeur interne de résultat - - - mysqli_result::fetch_all - mysqli_fetch_all - N/A - Lit toutes les lignes de résultats dans un tableau associatif, numérique, ou les deux. &mysqli.available.mysqlnd; - - - mysqli_result::fetch_array - mysqli_fetch_array - N/A - Retourne une ligne de résultat sous la forme d'un tableau associatif, d'un tableau indexé, ou les deux - - - mysqli_result::fetch_assoc - mysqli_fetch_assoc - N/A - Récupère une ligne de résultat sous forme de tableau associatif - - - mysqli_result::fetch_column - mysqli_fetch_column - N/A - Récupère une seule colonne de la ligne suivante d'un ensemble de résultats - - - mysqli_result::fetch_field_direct - mysqli_fetch_field_direct - N/A - Récupère les métadonnées d'un champ unique - - - mysqli_result::fetch_field - mysqli_fetch_field - N/A - Retourne le prochain champ dans le jeu de résultats - - - mysqli_result::fetch_fields - mysqli_fetch_fields - N/A - Retourne un tableau d'objets représentant les champs dans le résultat - - - mysqli_result::fetch_object - mysqli_fetch_object - N/A - Retourne la ligne courante d'un jeu de résultats sous forme d'objet - - - mysqli_result::fetch_row - mysqli_fetch_row - N/A - Récupère une ligne de résultat sous forme de tableau indexé - - - mysqli_result::field_seek - mysqli_field_seek - N/A - Déplace le pointeur de résultat sur le champ spécifié - - - mysqli_result::free, - mysqli_result::close, - mysqli_result::free_result - mysqli_free_result - N/A - Libère la mémoire associée à un résultat - - - -
- - - Résumé des méthodes <classname>mysqli_driver</classname> - - - - MySQL_Driver - - - Interface POO - Interface procédurale - Alias (Ne plus utiliser) - Description - - - - - &Properties; - - - $mysqli_driver::mysqli_report - mysqli_report - N/A - Définit le mode du rapport d'erreur de mysqli - - - &Methods; - - - mysqli_driver::embedded_server_end - mysqli_embedded_server_end - N/A - Non documenté - - - mysqli_driver::embedded_server_start - mysqli_embedded_server_start - N/A - Non documenté - - - -
- - - - Les alias sont fournis pour assurer la compatibilité ascendante. - Ne pas les utiliser dans de nouveaux projets. - - - - - -