mysql_list_tables

(PHP 4, PHP 5)

mysql_list_tables — Liste les tables d'une base de données MySQL

Avertissement

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

resource mysql_list_tables ( string $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