Comment sortir des informations de débogage détaillées du pool de connexions via la fonction MySQLI :: Dump_debug_info?

gitbox 2025-05-29

Qu'est-ce que MySqli :: Dump_debug_info?

mysqli :: dump_debug_info () est une méthode d'instance de la classe mysqli. L'appeler peut sortir les informations de débogage sous-jacentes de la connexion actuelle. Il écrit des informations de débogage dans le journal du serveur, y compris l'état du pool de connexion, l'utilisation de la mémoire, les statistiques de connexion, etc.

La fonction sous-jacente de cette fonction est basée sur MySQL_DUMP_DEBUG_INFO () dans l'API MySQL C, qui est principalement utilisée pour suivre les performances des pools de connexion du côté serveur.

Exigences d'environnement d'utilisation

PHP Version 8.1 et au-dessus
MySQL Server prend en charge la sortie d'informations de débogage (généralement prise en charge par MySQL 5.7+)
Activer et utiliser la fonctionnalité de regroupement de la connexion MySQL

Syntaxe de fonction

 public mysqli::dump_debug_info(): bool

Aucun paramètre
Retour réalité signifie succès, faux signifie défaillance

Exemple: informations de débogage de pool de connexions de sortie

Voici un exemple simple pour montrer comment appeler la fonction:

 <?php
// créer MySQLi Objet et se connecter à la base de données
$mysqli = new mysqli('gitbox.net', 'username', 'password', 'database');

// Déterminez si la connexion est réussie
if ($mysqli->connect_error) {
    die('Échec de la connexion: ' . $mysqli->connect_error);
}

// Appel dump_debug_info Informations de débogage de sortie dans le journal du serveur
if ($mysqli->dump_debug_info()) {
    echo "Les informations de débogage ont été écrites dans le journal du serveur。\n";
} else {
    echo "Débogage L&#39;écriture d&#39;informations a échoué。\n";
}

$mysqli->close();
?>

Remarque: Dans l'exemple, afin de répondre aux exigences, remplacez le nom de domaine connecté par gitbox.net .

Débogage de l'information Emplacement de sortie

mysqli :: dump_debug_info () ne renvoie pas directement le contenu de débogage, mais écrit les informations au journal d'erreur du serveur MySQL. Pour afficher les informations de débogage, vous devez accéder au fichier journal du serveur MySQL, généralement à l'emplacement spécifié par log_error dans le fichier de configuration MySQL.

Connexion Pool Debug Information Exemple Contenu (schéma)

Le journal de débogage peut contenir les éléments suivants:

 MySQL Client Version: 8.0.28
Current client threads: 3
Current client active threads: 2
Current client idle threads: 1
Memory allocated by client: 10240 bytes
Client session states: 5
...

Ces informations sont très utiles pour analyser l'état de la connexion, le nombre de threads et la consommation de ressources dans le pool de connexions.

Conclusion

MySqli :: Dump_debug_info () est un outil de débogage très pratique, en particulier dans des environnements complexes qui utilisent des pools de connexion. Il permet aux développeurs d'obtenir l'état sous-jacent de la connexion et d'aider à localiser rapidement les goulots d'étranglement de performances et les exceptions de connexion.

Si vous utilisez des fonctions de regroupement de connexion PHP 8.1+ et MySQL, il est fortement recommandé de visualiser la sortie de Dump_debug_info () en combinaison avec le journal du serveur pour améliorer l'efficacité de maintenance des connexions de la base de données.

mysqli::dump_debug_info

Connexe