mysql_fetch_field

(PHP 4, PHP 5)

mysql_fetch_field — Retourne les données enregistrées dans une colonne MySQL sous forme d'objet

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 et ces entrées de la FAQ pour plus d'informations. Alternatives à cette fonction :

Description

mysql_fetch_field ( resource $result [, int $field_offset = 0 ] ) : object

Retourne un objet contenant les informations sur les champs. Cette fonction peut être utilisée pour obtenir des informations sur les champs de la requête fournie result.

Retour à la première page de Manuel PHP Table des matières Haut

Liste de paramètres

result: La ressource 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. Si la position du champ n'est pas spécifiée, le champ suivant qui n'a pas encore été récupéré par cette fonction est alors récupéré. field_offset commence à 0.

Retour à la première page de Manuel PHP Table des matières Haut

Valeurs de retour

Retourne un objet contenant les informations sur les champs. Les propriétés de l'objet sont les suivantes :

"name" : nom de la colonne
"table" : nom de la table pour la colonne, qui pourra être l'alias si un alias a été défini.
"max_length" : taille maximale de la colonne
"not_null" : 1 si la colonne ne peut pas être NULL
"primary_key" : 1 si la colonne est une clé primaire
"unique_key" : 1 si la colonne est une clé unique
"multiple_key" : 1 si la colonne est une clé non unique
"numeric" : 1 si la colonne est numérique
"blob" : 1 si la colonne est BLOB
"type" : le type de la colonne
"unsigned" : 1 si la colonne est non signée
"zerofill" : 1 si la colonne est complétée par des zéro

Retour à la première page de Manuel PHP Table des matières Haut

Exemples

Exemple #1 Exemple avec mysql_fetch_field()


<?php
$conn = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$conn) {
   die('Impossible de se connecter : ' . mysql_error());
}
mysql_select_db('database');
$result = mysql_query('select * from table');
if (!$result) {
   die('Échec de la requête : ' . mysql_error());
}
/* Lecture des méta données de la colonne */
$i = 0;
while ($i < mysql_num_fields($result)) {
   echo "Détails sur la colonne $i:<br />\n";
   $meta = mysql_fetch_field($result, $i);
   if (!$meta) {
      echo "Aucun détail disponible<br />\n";
   }
   echo "<pre>
    blob:         $meta->blob
    max_length:   $meta->max_length
    multiple_key: $meta->multiple_key
    name:         $meta->name
    not_null:     $meta->not_null
    numeric:      $meta->numeric
    primary_key:  $meta->primary_key
    table:        $meta->table
    type:         $meta->type
    unique_key:   $meta->unique_key
    unsigned:     $meta->unsigned
    zerofill:     $meta->zerofill
   </pre>";
   $i++;
}
mysql_free_result($result);
?>

Retour à la première page de Manuel PHP Table des matières Haut

Notes

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

Note:
Si les champs ou les noms de table utilisent un alias dans la requête SQL, le nom utilisé dans l'alias sera retourné. Le nom original peut être récupéré en utilisant la méthode mysqli_result::fetch_field().

Retour à la première page de Manuel PHP Table des matières Haut

Voir aussi

mysql_field_seek() - Déplace le pointeur de résultat vers une position donnée

Rechercher une fonction PHP

Version en cache

05/11/2024 16:36:30 Cette version de la page est en cache (à la date du 05/11/2024 16:36:30) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.mysql-fetch-field.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut