Forum und email

mysqli_ping

mysqli->ping()

(PHP 5)

mysqli->ping() — Ping la connexion au serveur et reconnecte si elle n'existe plus

Description

Style procédural

bool mysqli_ping ( mysqli $link )

Style orienté objet (méthode)

mysqli
bool ping ( void )

Ping la connexion pour s'assurer que le serveur est bien en fonctionnement. S'il n'est pas en fonctionnement, et que l'option global mysqli.reconnect est activée, une connexion automatique sera tentée.

Cette fonction peut être utilisée par les clients qui font de lourds traitements, pour vérifier si le serveur a fermé la connexion et, ainsi, tenter une reconnexion si nécessaire.

Liste de paramètres

link

Style procédural uniquement : Un identifiant de lien retourné par la fonction mysqli_connect() ou par la fonction mysqli_init()

Valeurs de retour

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Exemples

Example#1 Style orienté objet

<?php
$mysqli 
= new mysqli("localhost""my_user""my_password""world");

/* Vérification de la connexion */
if (mysqli_connect_errno()) {
    
printf("Échec de la connexion : %s\n"mysqli_connect_error());
    exit();
}

/* Vérification si la connexion est toujours active */
if ($mysqli->ping()) {
    
printf ("La connexion est Ok !\n");
} else {
    
printf ("Erreur : %s\n"$mysqli->error);
}

/* Fermeture de la connexion */
$mysqli->close();
?>

Example#2 Style procédural

<?php
$link 
mysqli_connect("localhost""my_user""my_password""world");

/* Vérification de la connexion */
if (mysqli_connect_errno()) {
    
printf("Échec de la connexion : %s\n"mysqli_connect_error());
    exit();
}

/* Vérification si la connexion est toujours active */
if (mysqli_ping($link)) {
    
printf ("La connexion est Ok !\n");
} else {
    
printf ("Erreur : %s\n"mysqli_error($link));
}

/* Fermeture de la connexion */
mysqli_close($link);
?>

L'exemple ci-dessus va afficher :

La connexion est Ok !