mysql_close
(PHP 4, PHP 5)
mysql_close — Schließt eine Verbindung zu MySQL
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. Alternativen zu dieser Funktion umfassen:
- mysqli_close()
- PDO: Zuweisung des Wertes
null
zum PDO-Objekt
Beschreibung
$link_identifier
= NULL): bool
mysql_close() schließt die nicht persistente Verbindung
zum MySQL-Server, die mit der angegebenen Verbindungskennung verknüpft
ist. Wird link_identifier
nicht angegeben, wird die
zuletzt geöffnete Verbindung geschlossen.
Offene nicht-persistente MySQL Verbindungen und Ergebnismengen werden bei der Beendigung der PHP-Skipt-Ausführung automatisch zerstört. Obwohl also das explizite Schließen von offenen Verbindungen und das Freigeben von Ergebnismengen optional ist, wird es dennoch empfohlen. Dadurch werden unmittelbar Ressourcen an PHP und MySQL zurückgeben, was die Performance verbessern kann. Weitere Information ist unter Freigeben von Ressourcen zu finden.
Parameter-Liste
-
Verbindungs-Kennung
-
Die MySQL Verbindung. Wenn nicht angegeben, wird die letzte mit mysql_connect() geöffnete Verbindung verwendet. Wenn noch keine Verbindung hergestellt wurde wird ein
E_WARNING
Fehler geworfen.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.
Beispiele
Beispiel #1 mysql_close()-Beispiel
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Keine Verbindung möglich: ' . mysql_error());
}
echo 'Erfolgreich verbunden';
mysql_close($link);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Erfolgreich verbunden
Anmerkungen
Hinweis:
mysql_close() schließt keine persistenten Verbindungen, die mit mysql_pconnect() geöffnet wurden. Weitere Details sind der Manpage über Persistente Verbindungen zu entnehmen.
Siehe auch
- mysql_connect() - Öffnet eine Verbindung zu einem MySQL-Server
- mysql_free_result() - Gibt belegten Speicher wieder frei