mysql_ping

(PHP 4 >= 4.3.0, PHP 5)

mysql_ping — Pinga uma conexão com o servidor ou reconecta se não houver conexão

Aviso

Esta extensão foi descontinuada a partir do PHP 5.5.0 e foi removida no PHP 7.0.0. Em vez disso, as extensões MySQLi ou PDO_MySQL devem ser usadas. Veja também o guia MySQL: escolhendo uma API. Alternativas a esta função incluem:

Descrição

mysql_ping(resource $link_identifier = NULL): bool

Confere se a conexão com o servidor está funcionando ou não. Se ela tiver caído, tenta realizar uma conexão automática. Esta função pode ser usada em scripts que permanecem inativos por um longo tempo, para verificar se o servidor fechou ou não a conexão e reconectar se necessário.

Nota: A reconexão automática está desabilitada por padrão em versões do Mysql >= 5.0.3.

Parâmetros

link_identifier
A conexão MySQL. Se o identificador da conexão não for especificado, a última conexão aberta por mysql_connect() será usada. Se não houver uma conexão anterior, haverá uma tentativa de criar uma como se mysql_connect() tivesse sido chamada sem argumentos. Se nenhuma conexão for encontrada ou estabelecida, um erro de nível E_WARNING será gerado.

Valor Retornado

Retorna true se a conexão com o servidor MySQL estiver funcionando, caso contrário retorna false.

Exemplos

Exemplo #1 Exemplo mysql_ping()

<?php
set_time_limit(0);

$conn = mysql_connect('localhost', 'usuario', 'senha');
$db = mysql_select_db('mydb');

/* Supondo que esta consulta levará muito tempo */
$result = mysql_query($sql);
if (!$result) {
echo 'Consulta #1 falhou, saindo.';
exit;
}

/* Certifique-se de que a conexão ainda esteja ativa; caso contrário, tente reconectar */
if (!mysql_ping($conn)) {
echo 'Conexão perdida, saindo após consulta #1';
exit;
}
mysql_free_result($result);

/* Então a conexão ainda está ativa, vamos executar outra consulta */
$result2 = mysql_query($sql2);
?>

Veja Também