Manuel PHP
PrécédentSuivant

mysql_list_fields

(PHP 3, PHP 4 , PHP 5)

mysql_list_fields -- Liste les champs du résultat MySQL

Description

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

Note : 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.

mysql_list_fields() recherche les informations relatives à la table table_name sur la connexion MySQL courante ou sûr la connexion spécifiée par link_identifier. Les arguments sont la base de données database_name et le nom de la table table_name. Un pointeur de résultat est retourné et pourra être passé à mysql_field_flags(), mysql_field_len(), mysql_field_name() et mysql_field_type().

Un identifiant de résultat est un entier positif. La fonction retourne -1 si une erreur survient. Une chaîne décrivant le problème rencontré sera placée dans la variable $phperrmsg et, à moins que la fonction n'ait été appelée sous la forme @mysql(), cette erreur sera aussi affichée.

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 :

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

Pour des raisons de compatibilité ascendante, mysql_listfields() est encore disponible.

Voir aussi mysql_field_flags() et mysql_info().

PrécédentSommaireSuivant
mysql_list_dbsNiveau supérieurmysql_list_processes