(PHP 4 >= 4.3.0, PHP 5)
mysql_ping — Ping a server connection or reconnect if there is no connection
Diese Erweiterung ist seit PHP 5.5.0 als veraltet markiert und wurde in PHP 7.0.0 entfernt. Verwenden Sie stattdessen die Erweiterungen MySQLi oder PDO_MySQL. Weitere Informationen finden Sie im Ratgeber MySQL: Auswahl einer API und den zugehörigen FAQ. Alternativen zu dieser Funktion umfassen:
$link_identifier = NULL
] ) : bool
Ü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:
Die automatische Wiederherstellung der Verbindung ist standardmäßig in MySQL >= 5.0.3 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);
?>