PHP mysqli fetch_field_direct() Fonction

❮ Référence PHP MySQLi

Exemple - Style orienté objet

Retourne les métadonnées d'un seul champ dans le jeu de résultats, puis imprime le nom du 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 les informations sur le champ pour la colonne "Age"
$fieldinfo = $result -> fetch_field_direct(1);

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_direct() / mysqli_fetch_field_direct() retourne des métadonnées pour un seul champ dans un jeu de résultats, sous forme d'objet.

Syntaxe

Style orienté objet :

$mysqli_result -> fetch_field_direct( fieldnr )

Style procédural :

mysqli_fetch_field_direct( result, fieldnr )

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()
fieldnr Requis. Spécifie le numéro du champ. Doit être un entier de 0 à nombre de champs -1

Détails Techniques

Valeur de Retour : Retourne un objet contenant des informations de définition de 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 - valeur par défaut pour ce champ
  • 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 les métadonnées d'un seul champ dans le jeu de résultats, puis imprime le nom du 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 les informations sur le champ pour la colonne "Age"
$fieldinfo = mysqli_fetch_field_direct($result, 1);

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