OUJOOD.COM
Définition et utilisation de la fonction host_info() / mysqli_get_host_info() en PHP
PHP Version: 5+
La fonction host_info() ou mysqli_get_host_info() retourne le nom d'hôte et le type de connexion du serveur MySQL auquel une connexion a été établie.
Syntaxes orientées objet et procédurales
Syntaxe orientée objet
$mysqli = new mysqli('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); echo $mysqli->host_info;
Syntaxe procédurale
$mysqli = mysqli_connect('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); echo mysqli_get_host_info($mysqli);
Valeurs possibles et paramètres
La fonction retourne une chaîne de caractères contenant le nom d'hôte et le type de connexion du serveur MySQL. Le type de connexion peut être l'un des suivants :
* `TCP/IP` : connexion via le protocole TCP/IP * `SOCKET` : connexion via le socket Unix * `NAMEDPIPE` : connexion via le named pipe WindowsExemples pratiques
Exemple orienté objet
Exemple : 📋 Copier le code
<?php $mysqli = new mysqli('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); // Affiche le nom d'hôte et le type de connexion echo $mysqli->host_info; ?>
Sortie :
localhost via TCP/IP
Exemple procédural
Exemple : 📋 Copier le code
<?php $mysqli = mysqli_connect('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); // Affiche le nom d'hôte et le type de connexion echo mysqli_get_host_info($mysqli); ?>
Sortie :
localhost via TCP/IP
Astuces et conseils d'utilisation pratique
- * La fonction host_info() est utile pour vérifier le nom d'hôte et le type de connexion du serveur MySQL auquel une connexion a été établie.
- * La fonction peut être utilisée pour déterminer le type de connexion utilisé par une application PHP.
- * La fonction peut être utilisée pour générer un message d'erreur personnalisé en cas de connexion incorrecte au serveur MySQL.
Cas d'utilisation de la fonction host_info() en PHP
Cas 1 : Vérifier le nom d'hôte et le type de connexion
Dans ce cas, la fonction est utilisée pour vérifier si la connexion au serveur MySQL a été établie correctement.
Exemple orienté objet:
Exemple : 📋 Copier le code
$mysqli = new mysqli('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); // Vérifier le nom d'hôte et le type de connexion if ($mysqli->host_info === 'localhost via TCP/IP') { // La connexion est établie } else { // La connexion n'est pas établie }?>
Exemple procédural:
Exemple : 📋 Copier le code
$mysqli = mysqli_connect('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); // Vérifier le nom d'hôte et le type de connexion if (mysqli_get_host_info($mysqli) === 'localhost via TCP/IP') { // La connexion est établie } else { // La connexion n'est pas établie }?>
Cas 2 : Déterminer le type de connexion utilisé
Dans ce cas, la fonction est utilisée pour déterminer le type de connexion utilisé par une application PHP.
Exemple orienté objet:
Exemple : 📋 Copier le code
$mysqli = new mysqli('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); // Déterminer le type de connexion $type_connexion = $mysqli->host_info; // Afficher le type de connexion echo $type_connexion;?>
Exemple procédural:
Exemple : 📋 Copier le code
$mysqli = mysqli_connect('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); // Déterminer le type de connexion $type_connexion = mysqli_get_host_info($mysqli); // Afficher le type de connexion echo $type_connexion;?>
Cas 3 : Générer un message d'erreur personnalisé en cas de connexion incorrecte
Dans ce cas, la fonction est utilisée pour générer un message d'erreur personnalisé en cas de connexion incorrecte au serveur MySQL.
Exemple orienté objet:
Exemple : 📋 Copier le code
try { $mysqli = new mysqli('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); } catch (Exception $e) { // Générer un message d'erreur personnalisé $message_erreur = $e->getMessage() . ' : ' . $mysqli->host_info; // Afficher le message d'erreur echo $message_erreur; }?>
Exemple procédural:
Exemple : 📋 Copier le code
try { $mysqli = mysqli_connect('seveur', 'utilisateur, 'motDePasse', 'ma_base_de_données'); } catch (Exception $e) { // Générer un message d'erreur personnalisé $message_erreur = $e->getMessage() . ' : ' . mysqli_get_host_info($mysqli); // Afficher le message d'erreur echo $message_erreur; }?>
Ces cas d'utilisation ne sont que quelques exemples parmi de nombreux autres. La fonction host_info() ou mysqli_get_host_info() peut être utilisée dans de nombreuses situations différentes, en fonction des besoins de votre application PHP.
Conclusion
La fonction host_info() ou mysqli_get_host_info() est une fonction utile pour obtenir des informations sur le serveur MySQL auquel une connexion a été établie.