mysql_list_dbs
(PHP 4, PHP 5)
mysql_list_dbs — Listet die verfügbaren Datenbanken (Schemata) auf einem MySQL-Server auf
Diese Funktion wurde in PHP 5.4.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:
- SQL Query:
SHOW DATABASES
Beschreibung
$link_identifier = NULL): resourceGibt eine Ergebniskennung zurück, die alle Datenbanken auf dem Datenbank-Server enthält.
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_WARNINGerzeugt.
Rückgabewerte
Gibt bei Erfolg eine Ergebniszeiger-Ressource zurück oder false bei
einem Fehler. Verwenden sie die Funktion
mysql_tablename(), um dieses Ergebnis zu durchlaufen
oder irgendeine der Funktionen, die mit Ergebnistabellen umgehen können,
wie etwa mysql_fetch_array().
Beispiele
Beispiel #1 mysql_list_dbs()-Beispiel
<?php
// Verwendung 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 den Namen einer Datenbank vom mysql_list_dbs-Aufruf
- mysql_select_db() - Wählt eine MySQL-Datenbank aus
