Pingt eine Serververbindung an und verbindet erneut, wenn keine Verbindung besteht

# mysql_ping

(PHP 4 >= 4.3.0, PHP 5)

mysql_ping — Pingt eine Serververbindung an und verbindet erneut, wenn keine Verbindung besteht

Warnung

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 bietet der Ratgeber MySQL: Auswahl einer API. Alternativen zu dieser Funktion umfassen:

- mysqli_ping()

### Beschreibung

function mysql_ping(resource `$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 verwenden, 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.

### Parameter-Liste

`link_identifier`

  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,
versuchen 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open