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

Descrição

bool mysql_ping ( [resource link_identifier] )

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

Parâmetros

link_identifier

A conexão MySQL. se o identificador de conexão não for especificado, a ultima conexão aberta por mysql_connect() é assumida. Se uma conexão assim não for encontrada, ela irá tentar criar uma como se a função mysql_connect() fosse chamada sem argumentos. Se uma conexão não for encontrada ou estabelecida, um aviso de nível E_WARNING é gerado.

Valores de retornado

Retorna TRUE se a conexão com o servidor MySQL esta funcionando, se não retorna FALSE.

Exemplos

Exemplo 1. Exemplo mysql_ping()

<?php
set_time_limit
(0);

$conn = mysql_connect('localhost', 'mysqluser', 'mypass');
$db   = mysql_select_db('mydb');

/* Assuming this query will take a long time */
$result = mysql_query($sql);
if (!
$result) {
    echo
'Query #1 failed, exiting.';
    exit;
}

/* Make sure the connection is still alive, if not, try to reconnect */
if (!mysql_ping($conn)) {
    echo
'Lost connection, exiting after query #1';
    exit;
}
mysql_free_result($result);

/* So the connection is still alive, let's run another query */
$result2 = mysql_query($sql2);
?>

Veja também

mysql_thread_id()
mysql_list_processes()