mysql_list_dbs

(PHP 4, PHP 5)

mysql_list_dbs Listet die verfügbaren Datenbanken (Schemata) auf einem MySQL-Server auf

Warnung

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 bietet der Ratgeber MySQL: Auswahl einer API. Alternativen zu dieser Funktion umfassen:

  • SQL Query: SHOW DATABASES

Beschreibung

mysql_list_dbs(resource$link_identifier = NULL): resource

Gibt eine Ergebniskennung zurück, die alle Datenbanken auf dem Datenbank-Server enthält.

Parameter-Liste

link_identifier

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

To Top