# mysql_list_fields

(PHP 4, PHP 5)

mysql_list_fields — Liste les champs d'une table MySQL

Avertissement

Cette fonction était obsolète en PHP 5.4.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 COLUMNS FROM sometable`

### Description

mysql_list_fields(string `$database_name`, string `$table_name`, resource `$link_identifier` = NULL): resource

Liste les champs de la table MySQL spécifiée.

La fonction mysql_list_fields() est obsolète. Il est préférable d'utiliser la fonction mysql_query() avec comme requête `SHOW COLUMNS FROM table [LIKE 'name']` à la place.

### Liste de paramètres

`database_name`

  Le nom de la base de données qui va être interrogée.

`table_name`

  Le nom de la table qui va être interrogée.

`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 survint.

Le résultat retourné peut être utilisé avec les fonctions mysql_field_flags(), mysql_field_len(), mysql_field_name() et mysql_field_type().

### Exemples

Exemple #1 Exemple d'alternative à mysql_list_fields()

`<?php
$result = mysql_query("SHOW COLUMNS FROM sometable");
if (!$result) {
echo 'Impossible d\'exécuter la requête : ' . mysql_error();
exit;
}
if (mysql_num_rows($result) > 0) {
while ($row = mysql_fetch_assoc($result)) {
print_r($row);
}
}
?>`

Résultat de l'exemple ci-dessus est similaire à :

    Array
    (
       [Field] => id
       [Type] => int(7)
       [Null] =>
       [Key] => PRI
       [Default] =>
       [Extra] => auto_increment
    )
    Array
    (
       [Field] => email
       [Type] => varchar(100)
       [Null] =>
       [Key] =>
       [Default] =>
       [Extra] =>
    )

### Notes

> Note:

> Pour des raisons de compatibilité ascendante, l'alias obsolète suivant peut être utilisé : mysql_listfields()

### Voir aussi

- mysql_field_flags() - Retourne des détails sur une colonne MySQL
- mysql_info() - Lit des informations à propos de la dernière requête MySQL