PHP Portal » PHP Handbuch » mysql_ping

Werbung

mysql_ping


(PHP 4 >= 4.3.0, PHP 5)

mysql_pingPing a server connection or reconnect if there is no connection

Beschreibung

bool mysql_ping ([ resource $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_WARNING erzeugt.

Rückgabewerte

Gibt TRUE zurück wenn die Verbindung zum MySQL Server noch besteht, ansonsten FALSE.

Beispiele

PHP Code
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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