mysql_drop_db

(PHP 4, PHP 5)

mysql_drop_db — Löschen eines Schemas

Beschreibung

bool mysql_drop_db ( string $database_name [, resource $link_identifier ] )

mysql_drop_db() versucht eine komplette Datenbank vom Server, der mit der übergebenen link_identifier Verbings-Kennung assoziiert wird, 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 des zu löschenden Schemas.
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 bei Erfolg TRUE zurück. Im Fehlerfall 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 "Schema my_db wurde erfolgreich gelöscht\n";
} else {
    echo 'Fehler beim Löschen des Schemas: ' . mysql_error() . "\n";
}
?>

Anmerkungen

Warnung

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()

Siehe auch

mysql_query() - Sendet eine Anfrage an MySQL