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

# 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:

- mysqli_ping()

### Descrição

function 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

- mysql_thread_id() - Retorna o ID da thread atual
- mysql_list_processes() - Lista os processos MySQL

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open