(PHP 4 >= 4.3.0, PHP 5)
mysql_ping — Sprawdza połączenie z serwerem, lub nawiązuje połączenie, jeśli go nie było
$identyfikator_połączenia
] )Sprawdza czy połączenie z serwerem działa poprawnie. Jeśli zostało zamknięte, następuje próba ponownego połączenia. Funkcja ta, w skryptach które pozostają długi czas w bezczynności, może służyć do sprawdzenia czy serwer zamknął połączenie i, jeśli zajdzie potrzeba, nawiązania go ponownie.
Informacja:
Od wersji MySQL 5.0.13 automatyczne ponawianie połączenia jest wyłączone.
identyfikator_połączeniaPołączenie MySQL.
Jeśli identyfikator połączenia nie zostanie podany, użyte zostanie ostatnie
połączenie otwarte przez mysql_connect(). Jeśli połączenie
takie nie zostanie znalezione, funkcja spróbuje nawiązać połączenie tak, jakby
wywołana została funkcja mysql_connect() bez argumentów.
Jeśli żadne połączenie nie zostanie znalezione lub nawiązane, wygenerowany
zostanie błąd poziomu E_WARNING.
Zwraca TRUE jeśli połączenie z serwerem działa poprawnie, w przeciwnym
przypadku zwraca FALSE.
Przykład #1 Przykład użycia mysql_ping()
<?php
set_time_limit(0);
$conn = mysql_connect('localhost', 'mysqluser', 'mypass');
$db = mysql_select_db('mydb');
/* Zakładamy, że wykonanie zapytania zajmie dużo czasu */
$result = mysql_query($sql);
if (!$result) {
echo 'Wykonanie zapytania #1 nie powiodło się, zamykanie.';
exit;
}
/* Upewniamy się, że połączenie jest aktywne, w przeciwnym wypadku ponawiamy je */
if (!mysql_ping($conn)) {
echo 'Połączenie zerwane, zamykanie po zapytaniu #1';
exit;
}
mysql_free_result($result);
/* Jeśli połączenie jest aktywne wykonujemy następne zapytanie */
$result2 = mysql_query($sql2);
?>