mysql_list_dbs

(PHP 4, PHP 5)

mysql_list_dbs — Auflistung der verfügbaren Datenbanken (Schemata) auf einem MySQL Server

Beschreibung

resource mysql_list_dbs ([ resource $Verbindungs-Kennung ] )

Liefert eine Ergebnis-Kennung, die alle Datenbanken auf dem Datenbankserver enthält.

Warnung

Dieses Feature ist seit PHP 5.4.0 DEPRECATED (veraltet). Sich auf dieses Feature zu verlassen ist in keiner Weise empfehlenswert.

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 bei Erfolg eine Ergebnis-Kennung resource zurück oder FALSE bei Fehlern. Nutzen sie die mysql_tablename() Function, um dieses Ergebnis zu durchlaufen oder irgendeine der Funktionen, die mit Ergebnistabellen umgehen, wie etwa mysql_fetch_array().

Beispiele

Beispiel #1 mysql_list_dbs() Beispiel


<?php
// Nutzung ohne mysql_list_dbs()
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
$res = mysql_query("SHOW DATABASES");

while ($row = mysql_fetch_assoc($res)) {
    echo $row['Database'] . "\n";
}

// Veraltet seit PHP 5.4.0
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
$db_list = mysql_list_dbs($link);

while ($row = mysql_fetch_object($db_list)) {
     echo $row->Database . "\n";
}
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

database1
database2
database3

Anmerkungen

Hinweis:
Für die Abwärtskompatibiliät kann der folgende veraltete Alias verwendet werden: mysql_listdbs()

Siehe auch

mysql_db_name() - Liefert Schema Namen vom Aufruf von mysql_list_dbs
mysql_select_db() - Auswahl einer MySQL Datenbank