mysql_drop_db
(PHP 4, PHP 5)
mysql_drop_db — Löscht eine Datenbank
Diese Funktion wurde in PHP 4.3.0 als veraltet gekennzeichnet und wurde in PHP 7.0.0 zusammen mit der gesamten ursprünglichen MySQL-Erweiterung entfernt. Stattdessen sollten die aktiv entwickelten Erweiterungen MySQLi oder PDO_MySQL verwendet werden. Weitere Informationen finden Sie im Ratgeber MySQL: Auswahl einer API. Alternativen zu dieser Funktion umfassen:
- Eine
DROP DATABASE-Anweisung ausführen
Beschreibung
$database_name, resource $link_identifier = NULL): bool
mysql_drop_db() versucht eine komplette Datenbank vom
Server, der mit der übergebenen Verbindungskennung
link_identifier verknüpft ist, zu löschen. Diese
Funktion ist veraltet. Stattdessen sollte mit der Funktion
mysql_query() der SQL-Befehl
DROP DATABASE ausgeführt werden.
Parameter-Liste
-
database_name -
Der Name der zu löschenden Datenbank.
-
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_WARNINGerzeugt.
Rückgabewerte
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Beispiele
Beispiel #1 mysql_drop_db()-Alternativbeispiel
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Verbindung nicht möglich: ' . mysql_error());
}
$sql = 'DROP DATABASE my_db';
if (mysql_query($sql, $link)) {
echo "Datenbank my_db wurde erfolgreich gelöscht\n";
} else {
echo 'Fehler beim Löschen der Datenbank: ' . mysql_error() . "\n";
}
?>
Anmerkungen
Diese Funktion steht nicht zur Verfügung, wenn das MySQL-Modul gegen eine MySQL 4.x Client-Bibliothek gelinkt wurde.
Hinweis:
Für die Abwärtskompatibiliät kann der folgende veraltete Alias verwendet werden: mysql_dropdb()
