mysqli_ping

(PHP 5)

mysqli_ping

(no version information, might be only in CVS)

mysqli->ping --  Revisa una conexión al servidor o intenta reconectar si la conexi???n se ha perdido.

Descripción

Estilo por procedimientos:

bool mysqli_ping ( objeto identificador_de_enlace)

Estilo orientado a objetos (método):

class mysqli {

bool ping ( void )

}

Checa si la conexión al servidor está operando. Si se perdi´ y la opción global mysqli.reconnect esta activa se intenta una reconexión automática.

Esta función puede ser usada por clientes que duran mucho tiempo inactivos, para checar si el servidor ha verrado al conexión y reconectarse en caso necesario.

Valores Regresados

Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.

Ejemplos

Ejemplo 1. Estilo orientado a objetos

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

/* check connection */
if (mysqli_connect_errno()) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* check if server is alive */
if ($mysqli->ping()) {
    
printf ("Our connection is ok!\n");
} else {
    
printf ("Error: %s\n", $mysqli->error);
}

/* close connection */
$mysqli->close();
?>

Ejemplo 2. Estilo por procedimientos

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

/* check connection */
if (mysqli_connect_errno()) {
    
printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* check if server is alive */
if (mysqli_ping($link)) {
    
printf ("Our connection is ok!\n");
} else {
    
printf ("Error: %s\n", mysqli_error($link));
}

/* close connection */
mysqli_close($link);
?>

Los ejemplos anteriores producirá la siguiente salida:

Our connection is ok!