mysql_pconnect
mysql_query
MySQL Funktionen
PHP Manual

# mysql_ping

(PHP 4 >= 4.3.0, PHP 5)

mysql_ping — Ping 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

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

mysql_pconnect
mysql_query
MySQL Funktionen
PHP Manual