An easier way to unpack nested array elements
$array = [
[1, 2],
[3, 4],
];
foreach ($array as [$a, $b]) {
echo "A: $a; B: $b\n";
}
(PHP 4, PHP 5, PHP 7, PHP 8)
La structure de langage foreach fournit une façon simple de
parcourir des tableaux. foreach ne fonctionne que pour les tableaux
et les objets, et émettra une erreur si vous tentez de l'utiliser sur une
variable de type différent ou une variable non initialisée. Il existe
deux syntaxes :
foreach (iterable_expression as $value){
//commandes
}
foreach (iterable_expression as $key => $value){
//commandes
}
La première forme passe en revue le tableau
iterable_expression. À chaque itération, la valeur de
l'élément courant est assignée à $value.
La seconde forme assignera en plus la clé de l'élément courant
à la variable $key à chaque itération.
Il est à noter que foreach ne modifie pas le pointeur
interne du tableau, qui est utilisé par les fonctions tel que
current() et key().
Il est possible de personnaliser l'itération sur des objets.
Vous pouvez modifier facilement les éléments d'un tableau en
précédent $value d'un &. Ceci assignera une
référence au lieu de copier la
valeur.
<?php
$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
$value = $value * 2;
}
// $arr vaut maintenant array(2, 4, 6, 8)
unset($value); // Détruit la référence sur le dernier élément
?>
La référence de $value et le dernier élément du tableau
sont conservés après l'exécution de la boucle foreach.
Il est recommandé de les détruire en utilisant la fonction
unset(). Sinon, vous ressentirez le
comportement suivant :
<?php
$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
$value = $value * 2;
}
// $arr est maintenant array(2, 4, 6, 8)
// sans un unset($value), $value est toujours une référence au dernier élément: $arr[3]
foreach ($arr as $key => $value) {
// $arr[3] sera mis à jour avec chaque valeur de $arr...
echo "{$key} => {$value} ";
print_r($arr);
}
// ...jusqu'à ce que finalement la valeur de deuxième à dernière soit copiée sur la dernière valeur
// sortie :
// 0 => 2 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 2 )
// 1 => 4 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 4 )
// 2 => 6 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 6 )
// 3 => 6 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 6 )
?>Il est possible d'itérer la valeur d'un tableau constant par référence :
<?php
foreach (array(1, 2, 3, 4) as &$value) {
$value = $value * 2;
}
?>
Note:
foreachne supporte pas la suppression des messages d'erreur utilisant@.
Voici quelques exemples de plus :
<?php
/* exemple foreach 1 : la valeur seulement */
$a = array(1, 2, 3, 17);
foreach ($a as $v) {
echo "Valeur courante de \$a: $v.\n";
}
/* exemple foreach 2 : la valeur et sa clé d'index */
$a = array(1, 2, 3, 17);
$i = 0; /* uniquement pour l'illustration */
foreach ($a as $v) {
echo "\$a[$i] => $v.\n";
$i++;
}
/* exemple foreach 3 : la clé et la valeur */
$a = array(
"un" => 1,
"deux" => 2,
"trois" => 3,
"dix-sept" => 17
);
foreach ($a as $k => $v) {
echo "\$a[$k] => $v.\n";
}
/* exemple foreach 4 : tableaux multidimensionnels */
$a = array();
$a[0][0] = "a";
$a[0][1] = "b";
$a[1][0] = "y";
$a[1][1] = "z";
foreach ($a as $v1) {
foreach ($v1 as $v2) {
echo "$v2\n";
}
}
/* exemple foreach 5 : tableaux dynamiques */
foreach (array(1, 2, 3, 4, 5) as $v) {
echo "$v\n";
}
?>(PHP 5 >= 5.5.0, PHP 7, PHP 8)
Il est possible d'itérer dans un tableau de tableaux, et d'en extraire les tableaux internes dans des variables, en fournissant une liste list() comme valeur.
Par exemple :
<?php
$array = [
[1, 2],
[3, 4],
];
foreach ($array as list($a, $b)) {
// $a contient le premier élément du tableau interne,
// et $b contient le second élément.
echo "A: $a; B: $b\n";
}
?>L'exemple ci-dessus va afficher :
A: 1; B: 2 A: 3; B: 4
Vous pouvez fournir moins d'éléments dans la fonction list() qu'il n'y en a dans le tableau interne, auquel cas, les valeurs du tableau les plus à droite seront ignorées :
<?php
$array = [
[1, 2],
[3, 4],
];
foreach ($array as list($a)) {
// Notez qu'il n'y a pas de $b ici.
echo "$a\n";
}
?>L'exemple ci-dessus va afficher :
1 3
Une notification sera générée s'il n'y a pas assez d'éléments dans le tableau pour remplir la fonction list() :
<?php
$array = [
[1, 2],
[3, 4],
];
foreach ($array as list($a, $b, $c)) {
echo "A: $a; B: $b; C: $c\n";
}
?>L'exemple ci-dessus va afficher :
Notice: Undefined offset: 2 in example.php on line 7 A: 1; B: 2; C: Notice: Undefined offset: 2 in example.php on line 7 A: 3; B: 4; C:
An easier way to unpack nested array elements
$array = [
[1, 2],
[3, 4],
];
foreach ($array as [$a, $b]) {
echo "A: $a; B: $b\n";
}