mysqli::ping

mysqli_ping

(PHP 5, PHP 7)

mysqli::ping -- mysqli_pingComprueba la conexión al servidor, o trata de reconectar si se perdió la conexión

Descripción

Estilo orientado a objetos

mysqli::ping ( void ) : bool

Estilo por procedimientos

mysqli_ping ( mysqli $link ) : bool

Comprueba si la conexión al servidor funciona. Si se ha perdido, y la opción global mysqli.reconnect está habilitada, se intenta realizar una reconexión automática.

Esta función la pueden utilizar clientes que permanecen inactivos por mucho tiempo para comprobar si el servidor ha cerrado la conexión y reconectar si fuera necesario.

Parámetros

link

Sólo estilo por procediminetos: Un identificador de enlace devuelto por mysqli_connect() o mysqli_init()

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de mysqli::ping()

Estilo orientado a objetos

<?php
$mysqli 
= new mysqli("localhost""mi_usuario""mi_contraseña""world");

/* comprobar la conexión */
if ($mysqli->connect_errno) {
    
printf("Conexión fallida: %s\n"$mysqli->connect_error);
    exit();
}

/* comprobar si el servidor sigue vivo */
if ($mysqli->ping()) {
    
printf ("¡La conexión está bien!\n");
} else {
    
printf ("Error: %s\n"$mysqli->error);
}

/* cerrar la conexión */
$mysqli->close();
?>

Estilo por procedimientos

<?php
$enlace 
mysqli_connect("localhost""mi_usuario""mi_contraseña""world");

/* comprobar la conexión */
if (mysqli_connect_errno()) {
    
printf("Conexión fallida: %s\n"mysqli_connect_error());
    exit();
}

/* comprobar si el servidor sigue funcionando */
if (mysqli_ping($enlace)) {
    
printf ("¡La conexión está bien!\n");
} else {
    
printf ("Error: %s\n"mysqli_error($enlace));
}

/* cerrar la conexión */
mysqli_close($enlace);
?>

El resultado de los ejemplos sería:

¡La conexión está bien!