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