(PHP 4 >= 4.3.0, PHP 5)
mysql_ping — Ping a server connection or reconnect if there is no connection
$link_identifier
] )
Überprüft, ob die Verbindung zum Server
funktioniert oder nicht. Ist die Verbindung abgebrochen wird ein
automatischer Reconnect versucht. Diese Funktion können Sie in PHP-Skripts
benutzen, die längere Zeit untätig bleiben, um zu prüfen, ob der Server
die Verbindung abgebaut hat oder nicht und im Bedarfsfall wird versucht
die Verbindung wieder herzustellen.
Rückgabewert: mysql_ping() gibt TRUE zurück, wenn
die Verbindung zum Server funktioniert, ansonsten FALSE.
Hinweis:
Ab MySQL 5.0.13 ist die automatische Wiederherstellung der Verbindung deaktiviert.
Verbindungs-KennungDie MySQL-Verbindung.
Wird die Verbindungskennung nicht angegeben, wird die letzte durch
mysql_connect() geöffnete Verbindung angenommen. Falls
keine solche Verbindung gefunden wird, wird versucht, eine Verbindung
aufzubauen, wie es beim Aufruf von mysql_connect() ohne
Angabe von Argumenten der Fall wäre. Falls zufällig keine Verbindung gefunden
oder aufgebaut werden kann, wird eine Warnung der Stufe
E_WARNING erzeugt.
Gibt TRUE zurück wenn die Verbindung zum MySQL Server noch besteht,
ansonsten FALSE.
Beispiel #1 mysql_ping() Beispiel
<?php
set_time_limit(0);
$conn = mysql_connect('localhost', 'mysqluser', 'mypass');
$db = mysql_select_db('mydb');
/* Annahme: diese Abfrage dauert sehr lange */
$result = mysql_query($sql);
if (!$result) {
echo 'Abfrage #1 fehlgeschlagen, aussteigen.';
exit;
}
/*
Sicherstellen, dass die Verbindung immer noch besteht, falls nicht, Versuch
diese wieder aufzubauen
*/
if (!mysql_ping($conn)) {
echo 'Verbindung verloren, Ausstieg nach Abfrage #1';
exit;
}
mysql_free_result($result);
/* Verbindung besteht noch, absetzen eine einer weiteren Abfrage */
$result2 = mysql_query($sql2);
?>