Manuel PHP
Précédent |  | Suivant

# mysqli_ping

(PHP 5)

mysqli_ping

(no version information, might be only in CVS)

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)

class 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

Exemple 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();
?>`

Exemple 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 !

Précédent | Sommaire | Suivant
mysqli_param_count | Niveau supérieur | mysqli_prepare