Konstrukcja foreach

Konstrukcja foreach umożliwia sekwencyjne przeglądanie elementów tablicy. Działa z tablicami i obiektami implementującymi interfejs Traversable. Istnieją dwie wersje składni: do przeglądania tylko wartości oraz do przeglądania kluczy i wartości.

Składnia

foreach (array as $value) {
	// ciało pętli
}

foreach (array as $key => $value) {
	// ciało pętli
}

Przykład

Proste przeglądanie elementów tablicy:

<?php
	$arr = [1, 2, 3, 4, 5];
	
	foreach ($arr as $value) {
		echo $value . '<br>';
	}
?>

Wynik wykonania kodu:

Przykład

Przeglądanie tablicy z pobieraniem kluczy i wartości:

<?php
	$arr = ['a' => 1, 'b' => 2, 'c' => 3];
	
	foreach ($arr as $key => $value) {
		echo "$key: $value<br>";
	}
?>

Wynik wykonania kodu:

a: 1
b: 2
c: 3

Przykład

Użycie referencji do modyfikacji elementów tablicy:

<?php
	$arr = [1, 2, 3, 4, 5];
	foreach ($arr as &$value) {
		$value *= 2;
	}
	
	unset($value);
	print_r($arr);
?>

Wynik wykonania kodu:

[2, 4, 6, 8, 10]

Zobacz też

funkcję array_map,
która stosuje funkcję callback do wszystkich elementów tablicy
funkcję array_walk,
która stosuje funkcję użytkownika do każdego elementu tablicy