(PHP 5, PHP 7, PHP 8)
mysqli::ping -- mysqli_ping — Faz ping em uma conexão de servidor ou tenta reconectar se a conexão cair
Estilo orientado a objetos
Estilo procedural
Verifica se a conexão com o servidor está funcionando. Se ele estiver inativo e a opção global mysqli.reconnect estiver habilitada, uma reconexão automática será tentada.
Nota: A configuração mysqli.reconnect do php.ini é ignorada pelo driver mysqlnd, então a reconexão automática nunca é tentada.
Esta função pode ser utilizada por clientes que ficam muito tempo ociosos, para verificar se o servidor encerrou a conexão e reconectar se necessário.
mysql
Somente no estilo procedural: Um objeto mysqli retornado por mysqli_connect() ou mysqli_init()
Se o relatório de erros da extensão mysqli estiver habilitado (MYSQLI_REPORT_ERROR
) e a operação solicitada falhar,
um aviso será gerado. Se, além disso, o modo for definido como MYSQLI_REPORT_STRICT
,
uma exceção mysqli_sql_exception será lançada em vez do aviso.
Exemplo #1 mysqli::ping() exemplo
Estilo orientado a objetos
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* verifique a conexão */
if ($mysqli->connect_errno) {
printf("Falha na conexão: %s\n", $mysqli->connect_error);
exit();
}
/* verifique se o servidor está ativo */
if ($mysqli->ping()) {
printf ("Nossa conexão está ok!\n");
} else {
printf ("Erro: %s\n", $mysqli->error);
}
/* encerra a conexão */
$mysqli->close();
?>
Estilo procedural
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* verifique a conexão */
if (mysqli_connect_errno()) {
printf("Falha na conexão: %s\n", mysqli_connect_error());
exit();
}
/* verifique se o servidor está ativo */
if (mysqli_ping($link)) {
printf ("Nossa conexão está ok!\n");
} else {
printf ("Erro: %s\n", mysqli_error($link));
}
/* encerra a conexão */
mysqli_close($link);
?>
Os exemplos acima produzirão:
Nossa conexão está ok!