(PHP 4, PHP 5)
mysql_list_dbs — Liste les bases de données disponibles sur le serveur MySQL
Alternatives suggérées
L'utilisation de cette extension est déconseillée. A la place, l'extension MySQLi ou PDO_MySQL devrait être utilisée. Voir aussi le guide MySQL : choisir une API ainsi que la FAQ associée pour plus d'informations. Les alternatives à cette fonction incluent :
- Requête SQL : SHOW DATABASES
$link_identifier = NULL
] )
mysql_list_dbs() retournera un identifiant de
résultat, qui contiendra les noms des bases de données
disponibles sur la connexion MySQL courante ou sur la connexion
spécifiée par link_identifier.
Cette fonction est devenue obsolète depuis PHP 5.4.0. Son utilisation est fortement déconseillée.
link_identifierLa connexion MySQL.
S'il n'est pas spécifié, la dernière connexion ouverte avec la fonction
mysql_connect() sera utilisée. Si une telle connexion
n'est pas trouvée, la fonction tentera d'ouvrir une connexion, comme si
la fonction mysql_connect() avait été appelée sans argument.
Si aucune connexion n'est trouvée ou établie, une alerte
E_WARNING est générée.
Retourne une ressource de pointeurs de résultats en cas de succès, ou FALSE si une
erreur survient. Utilisez la fonction mysql_tablename()
pour parcourir ce résultat ou tout autre fonction pour les résultats de table, comme
la fonction mysql_fetch_array().
Exemple #1 Exemple avec mysql_list_dbs()
<?php
// Utilisation sans 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";
}
// Obsolète depuis 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";
}
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
database1 database2 database3
Note:
Pour des raisons de compatibilité ascendante, l'alias obsolète suivant peut être utilisé : mysql_listdbs()