Manuel PHP - foreach - Le PHP Facile

foreach

(PHP 4, PHP 5)

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 :

<?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
?>

Le référencement de $value est seulement possible si le tableau parcouru peut être référencé (i.e. si c'est une variable). Le code suivant ne fonctionnera pas :

<?php
foreach (array(1, 2, 3, 4) as &$value) {
	$value = $value * 2;
}
?>

Avertissement

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().

Note:
foreach n'accepte pas l'opérateur de suppression des erreurs @.

Vous pouvez remarquer que les exemples suivants fonctionnent de manière identique :

<?php
$arr = array("un", "deux", "trois");
reset($arr);
while (list(, $value) = each($arr)) {
	echo "Valeur : $value<br />\n";
}

foreach ($arr as $value) {
	echo "Valeur : $value<br />\n";
}
?>

Les exemples suivants sont aussi fonctionnellement identiques :

<?php
$arr = array("un", "deux", "trois");
reset($arr);
while (list($key, $value) = each($arr)) {
	echo "Clé : $key; Valeur : $value<br />\n";
}

foreach ($arr as $key => $value) {
	echo "Clé : $key; Valeur : $value<br />\n";
}
?>

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";
}
?>

Extraction des tableaux internes avec list()

(PHP 5 >= 5.5.0)

PHP 5.5 ajout la possibilité 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:

for

Les structures de contrôle

break

Manuel PHP