mysql_ping
(PHP 4 >= 4.3.0, PHP 5)
mysql_ping — Ping a server connection or reconnect if there is no connection
Beschreibung
$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.
Parameter-Liste
-
Verbindungs-Kennung -
Die 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_WARNINGerzeugt.
Rückgabewerte
Gibt TRUE zurück wenn die Verbindung zum MySQL Server noch besteht,
ansonsten FALSE.
Beispiele
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);
?>
Siehe auch
- mysql_thread_id() - Zeigt die aktuelle Thread ID an
- mysql_list_processes() - Zeigt die MySQL Prozesse an
