# mysql_field_name

(PHP 4, PHP 5)

mysql_field_name — Retourne le nom d'une colonne dans un résultat MySQL

Avertissement

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

- mysqli_fetch_field_direct() [name] ou [orgname]
- PDOStatement::getColumnMeta() [name]

### Description

mysql_field_name(resource `$result`, int `$field_offset`): string|false

mysql_field_name() retourne le nom du champ de l'index spécifié.

### Liste de paramètres

`result`

  La resource de résultat qui vient d'être évaluée. Ce résultat vient de l'appel à la fonction mysql_query().

`field_offset`

  La position numérique du champ. `field_offset` commence à `0`. Si `field_offset` n'existe pas, une alerte de niveau `E_WARNING` sera générée.

### Valeurs de retour

Le nom du champ de l'index spécifié en cas de succès ou `false` si une erreur survient.

### Exemples

Exemple #1 Exemple avec mysql_field_name()

`<?php
/* Supposons que la table utilisée contienne trois champs :
* user_id
* username
* password.
*/
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Impossible de se connecter au serveur MySQL : ' . mysql_error());
}
$dbname = 'mydb';
$db_selected = mysql_select_db($dbname, $link);
if (!$db_selected) {
die("Impossible de se connecter à la base $dbname: " . mysql_error());
}
$res = mysql_query('select * from users', $link);
echo mysql_field_name($res, 0) . "\n";
echo mysql_field_name($res, 2);
?>`

L'exemple ci-dessus va afficher :

    user_id
    password

### Notes

> Note: Les noms des champs retournés par cette fonction sont sensibles à la casse.

> Note:

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

### Voir aussi

- mysql_field_type() - Retourne le type d'une colonne MySQL spécifique
- mysql_field_len() - Retourne la taille d'un champ de résultat MySQL