# mysql_list_tables

(PHP 4, PHP 5)

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

Avertissement

Cette fonction était obsolète en PHP 4.3.0, et la totalité de l'extension original MySQL a été supprimée en PHP 7.0.0. À la place, vous pouvez utiliser soit l'extension MySQLi, soit l'extension PDO_MySQL. Voir aussi MySQL : choisir une API du guide. Alternatives à cette fonction :

- Requête SQL : `SHOW TABLES FROM dbname`

### Description

mysql_list_tables(string `$database`, resource `$link_identifier` = NULL): resource|false

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 de niveau `E_WARNING` sera 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().

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