MySQL Funktionen
PHP Manual

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 Funktionen
PHP Manual