Manuel PHP
Précédent |  | Suivant

# mysql_list_fields

(PHP 3, PHP 4, PHP 5)

mysql_list_fields -- Liste les champs d'une table MySQL

## Description

resource mysql_list_fields ( string database_name, string table_name [, resource link_identifier] )

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

La fonction mysql_list_fields() est dépréciée. 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 `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 survint.

Le résultat retourné peut être utilisé avec les fonction 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); } } ?>`
L'exemple ci-dessus va afficher quelque chose de 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()
mysql_info()

Précédent | Sommaire | Suivant
mysql_list_dbs | Niveau supérieur | mysql_list_processes