mysql_fetch_array
(PHP 4, PHP 5)
mysql_fetch_array — Retourne une ligne de résultat MySQL sous la forme d'un tableau associatif, d'un tableau indexé, ou les deux
Cette extension est obsolète depuis PHP 5.5.0, et sera supprimée dans le futur. À la place, les extensions MySQLi ou PDO_MySQL doivent être utilisées. Voir aussi le guide MySQL : choix de l'API ainsi que la FAQ associée pour plus d'information. Voici les alternatives à cette fonction :
Description
$result
[, int $result_type
= MYSQL_BOTH
] )
mysql_fetch_array() retourne un tableau qui
contient la ligne demandée dans le résultat result
et déplace le pointeur de données interne d'un cran.
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().
-
result_type
-
Le type de tableau à récupérer. C'est une constante qui peut prendre les valeurs suivantes :
MYSQL_ASSOC
,MYSQL_NUM
, etMYSQL_BOTH
.
Valeurs de retour
Retourne un tableau de chaînes qui correspond à la ligne récupérée ou FALSE
s'il n'y a plus de lignes. Le type de tableau retourné dépend de la
définition du paramètre result_type
.
En utilisant MYSQL_BOTH
(défaut), vous
récupérerez un tableau contenant des indices associatifs et numériques.
En utilisant MYSQL_ASSOC
, vous ne récupérerez que
les indices associatifs (comme le fonctionnement de la fonction
mysql_fetch_assoc()), en utilisant MYSQL_NUM
,
vous ne récupérerez que les indices numériques (comme le fonctionnement
de la fonction mysql_fetch_row()).
Si plusieurs colonnes portent le même nom, la dernière colonne aura la priorité. Pour accéder aux autres colonnes du même nom, vous devez utiliser l'index numérique, ou faire un alias pour chaque colonne. Pour les alias de colonnes, vous ne pourrez pas accéder aux contenus avec les noms originaux des colonnes.
Exemples
Exemple #1 Requête avec duplication de nom de colonnes
<?php mysql_connect("localhost", "mysql_user", "mysql_password") or die("Impossible de se connecter : " . mysql_error()); mysql_select_db("mydb"); $result = mysql_query("SELECT id, name FROM mytable"); while ($row = mysql_fetch_array($result, MYSQL_NUM)) { printf("ID : %s Nom : %s", $row[0], $row[1]); } mysql_free_result($result); ?>
Exemple #3 mysql_fetch_array() avec MYSQL_ASSOC
<?php mysql_connect("localhost", "mysql_user", "mysql_password") or die("Impossible de se connecter : " . mysql_error()); mysql_select_db("mydb"); $result = mysql_query("SELECT id, name FROM mytable"); while ($row = mysql_fetch_array($result, MYSQL_ASSOC)) { printf("ID : %s Nom : %s", $row["id"], $row["name"]); } mysql_free_result($result); ?>
Exemple #4 mysql_fetch_array() avec MYSQL_BOTH
<?php mysql_connect("localhost", "mysql_user", "mysql_password") or die("Impossible de se connecter : " . mysql_error()); mysql_select_db("mydb"); $result = mysql_query("SELECT id, name FROM mytable"); while ($row = mysql_fetch_array($result, MYSQL_BOTH)) { printf ("ID : %s Nom : %s", $row[0], $row["name"]); } mysql_free_result($result); ?>
Notes
Note: Performance
Une chose importante à noter est que l'utilisation de mysql_fetch_array() n'est pas significativement plus lent que l'utilisation de mysql_fetch_row(), alors qu'il fournit des valeurs significatives ajoutées.
Note: Les noms des champs retournés par cette fonction sont sensibles à la casse.
Note: Cette fonction définit les champs NULL à la valeur PHP
NULL
.
Voir aussi
- mysql_fetch_row() - Retourne une ligne de résultat MySQL sous la forme d'un tableau
- mysql_fetch_assoc() - Lit une ligne de résultat MySQL dans un tableau associatif
- mysql_data_seek() - Déplace le pointeur interne de résultat MySQL
- mysql_query() - Envoie une requête à un serveur MySQL