PHP Dokumentation: Function mysql-ping
12. Januar 2010 von werner
mysql_ping
(PHP 4 >= 4.3.0, PHP 5)
mysql_ping — Ping a server connection or reconnect if there is no connection
Beschreibung
Ü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 durchmysql_connect() geöffnete Verbindung angenommen. Fallskeine solche Verbindung gefunden wird, wird versucht, eine Verbindungaufzubauen, wie es beim Aufruf von mysql_connect() ohneAngabe von Argumenten der Fall wäre. Falls zufällig keine Verbindung gefundenoder aufgebaut werden kann, wird eine Warnung der StufeE_WARNING erzeugt.
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
Loading ...