(PHP 4 >= 4.3.0, PHP 5)
mysql_ping — Efectuar un chequeo de respuesta (ping) sobre una conexión al servidor o reconectarse si no hay conexión
Esta extensión fue declarada obsoleta en PHP 5.5.0 y eliminada en PHP 7.0.0. En su lugar debería utilzarse las extensiones MySQLi o PDO_MySQL. Véase también la guía MySQL: elegir una API y sus P+F relacionadas para más información. Alternatives to this function include:
$link_identifier
= NULL
] ) : boolChequea si está activa o no la conexión con el servidor. Si ésta se ha caído, se intenta una reconexión automática. Esta función puede ser usada por scripts que permanecen pasivos durante largos espacios de tiempo, para chequear si el servidor ha cerrado la conexión y reconectarse de ser necesario.
Nota:
La reconexión automática está deshabilitada de forma predeterminada en versiones de MySQL >= 5.0.3.
link_identifier
La conexión MySQL. Si no
se especifica el identificador de enlace, se asume el último enlace abierto
por mysql_connect(). Si no se encuentra este enlace, se
intentará crear un nuevo enlace como si mysql_connect() hubiese sido invocada
sin argumentos. Si no se encuentra o establece ninguna conexión, se genera un error
de nivel E_WARNING
.
Devuelve TRUE
si la conexión con el servidor MySQL está funcionando, o
FALSE
si no.
Ejemplo #1 Un ejemplo de mysql_ping()
<?php
set_time_limit(0);
$conexión = mysql_connect('localhost', 'usuario_mysql', 'contraseña');
$bd = mysql_select_db('mi_bd');
/* Se asume que esta consulta toma mucho tiempo */
$resultado = mysql_query($sql);
if (!$resultado) {
echo 'La consulta #1 falló; Saliendo.';
exit;
}
/* Asegurarse de que la conexión sigue viva, si no, intentar una reconexión */
if (!mysql_ping($conexión)) {
echo 'Se ha perdido la conexión, saliendo después de la consulta #1';
exit;
}
mysql_free_result($resultado);
/* Ya que la conexión sigue viva, ejecutemos otra consulta */
$resultado2 = mysql_query($sql2);
?>