PHP mysqli fetch_field() Fonction

❮ Référence PHP MySQLi

Exemple - Style orienté objet

Retourne le prochain champ (colonne) dans le jeu de résultats, puis imprime le nom de chaque champ, le nom de la table et la longueur maximale :

<?php
$mysqli = new mysqli("localhost","my_user","my_password","my_db");

if ($mysqli -> connect_errno) {
echo "Échec de la connexion à MySQL : " . $mysqli -> connect_error;
exit();
}

$sql = "SELECT Lastname, Age FROM Persons ORDER BY Lastname";

if ($result = $mysqli -> query($sql)) {
// Obtenir des informations sur les champs pour tous les champs
while ($fieldinfo = $result -> fetch_field()) {
printf("Nom : %s\n", $fieldinfo -> name);
printf("Table : %s\n", $fieldinfo -> table);
printf("Long. max : %d\n", $fieldinfo -> max_length);
}
$result -> free_result();
}

$mysqli -> close();
?>

Consultez l'exemple de style procédural en bas.

Définition et Utilisation

La fonction fetch_field() / mysqli_fetch_field() retourne le prochain champ (colonne) dans le jeu de résultats, sous forme d'objet.

Syntaxe

Style orienté objet :

$mysqli_result -> fetch_field()

Style procédural :

mysqli_fetch_field( result )

Valeurs des Paramètres

Paramètre Description
result Requis. Spécifie un identifiant de jeu de résultats retourné par mysqli_query(), mysqli_store_result() ou mysqli_use_result()

Détails Techniques

Valeur de Retour : Retourne un objet contenant des informations sur la définition du champ. FALSE si aucune information n'est disponible. L'objet a les propriétés suivantes :
  • name - nom de la colonne
  • orgname - nom original de la colonne (si un alias est spécifié)
  • table - nom de la table
  • orgtable - nom original de la table (si un alias est spécifié)
  • def - réservé pour les valeurs par défaut, actuellement toujours ""
  • db - base de données (nouveau dans PHP 5.3.6)
  • catalog - nom du catalogue, toujours "def" (depuis PHP 5.3.6)
  • max_length - largeur maximale du champ
  • length - largeur du champ telle que spécifiée dans la définition de la table
  • charsetnr - numéro de jeu de caractères pour le champ
  • flags - drapeaux de bits pour le champ
  • type - type de données utilisé pour le champ
  • decimals - pour les champs entiers ; le nombre de décimales utilisées
Version PHP : 5+

Exemple - Style procédural

Retourne le prochain champ (colonne) dans le jeu de résultats, puis imprime le nom de chaque champ, le nom de la table et la longueur maximale :

<?php
$con = mysqli_connect("localhost","my_user","my_password","my_db");

if (mysqli_connect_errno()) {
echo "Échec de la connexion à MySQL : " . mysqli_connect_error();
exit();
}

$sql = "SELECT Lastname, Age FROM Persons ORDER BY Lastname";

if ($result = mysqli_query($con, $sql)) {
// Obtenir des informations sur les champs pour tous les champs
while ($fieldinfo = mysqli_fetch_field($result)) {
printf("Nom : %s\n", $fieldinfo -> name);
printf("Table : %s\n", $fieldinfo -> table);
printf("Long. max : %d\n", $fieldinfo -> max_length);
}
mysqli_free_result($result);
}

mysqli_close($con);
?>

❮ Référence PHP MySQLi