mysql_list_tables
(PHP 4, PHP 5)
mysql_list_tables — Liste les tables d'une base de données MySQL
Cette extension est obsolète depuis PHP 5.5.0, et sera supprimée dans le futur. À la place, les extensions MySQLi ou PDO_MySQL doivent être utilisées. Voir aussi le guide MySQL : choix de l'API ainsi que la FAQ associée pour plus d'information. Voici les alternatives à cette fonction :
- Requête SQL : SHOW TABLES FROM sometable
Description
$database
[, resource $link_identifier
= NULL
] )Liste les tables d'une base de données MySQL spécifiée.
Cette fonction est obsolète. Il est préférable d'utiliser la fonction mysql_query() pour effectuer la requête SQL SHOW TABLES [FROM db_name] [LIKE 'pattern'] à la place.
Liste de paramètres
-
database
-
Le nom de la base de données
-
link_identifier
-
La 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.
Valeurs de retour
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 pointeur de résultats ou tout autre fonction pour les résultats de tables, comme la fonction mysql_fetch_array().
Historique
Version | Description |
---|---|
4.3.7 | Cette fonction est devenue obsolète. |
Exemples
Exemple #1 Exemple d'alternative à mysql_list_tables()
<?php $dbname = 'mysql_dbname'; if (!mysql_connect('mysql_host', 'mysql_user', 'mysql_password')) { echo 'Impossible de se connecter à MySQL'; exit; } $sql = "SHOW TABLES FROM $dbname"; $result = mysql_query($sql); if (!$result) { echo "Erreur DB, impossible de lister les tables\n"; echo 'Erreur MySQL : ' . mysql_error(); exit; } while ($row = mysql_fetch_row($result)) { echo "Table : {$row[0]}\n"; } mysql_free_result($result); ?>
Notes
Note:
Pour des raisons de compatibilité ascendante, l'alias obsolète suivant peut être utilisé : mysql_listtables()
Voir aussi
- mysql_list_dbs() - Liste les bases de données disponibles sur le serveur MySQL
- mysql_tablename() - Lit le nom de la table qui contient un champ