How to Find the foreach Index with PHP

In this tutorial, we provide helpful methods to retrieve the foreach key in PHP.

Below, you can find three options with proper examples.

Using the key Variable

The key variable holds the key of each element inside the foreach loop. For numeric arrays, these keys act as sequential indices. In PHP, the foreach loop is structured like this:

<?php

foreach ($arrayName as $key => $value) {
  // code
}

?>

The $value variable contains the value of each element. Here is a complete example:

<?php

$array = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];

foreach ($array as $key => $value) {
  echo "The key is = " . $key . ", and value is = " . $value;
  echo "\n";
}

?>

Here, $key stores the key of the current iteration, and $value stores the corresponding element.

The output will look as follows:

The key is = 0, and value is = 1
The key is = 1, and value is = 2
The key is = 2, and value is = 3
The key is = 3, and value is = 4
The key is = 4, and value is = 5
The key is = 5, and value is = 6
The key is = 6, and value is = 7
The key is = 7, and value is = 8
The key is = 8, and value is = 9
The key is = 9, and value is = 10

Using a Manual Counter

You can also use a separate counter variable to track iteration order. This is useful when you need a guaranteed sequential number regardless of the array's actual keys.

<?php

// Declare an array
$arr = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
$counter = 0;

foreach ($arr as $key => $val) {
  echo "The counter is $counter";
  $counter++;
  echo "\n";
}

?>

The counter must be initialized before the loop and incremented on each iteration.

The output will look like this:

The counter is 0
The counter is 1
The counter is 2
The counter is 3
The counter is 4
The counter is 5
The counter is 6
The counter is 7
The counter is 8
The counter is 9

Combining key and a Counter

This example demonstrates how to reference both the actual key and a manual counter within the same loop.

<?php

// Declare an array
$arr = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
$counter = 0;

foreach ($arr as $key => $value) {
  echo "Key: $key, Counter: $counter";
  $counter = $key + 1;
  echo "\n";
}

?>

In this case, the $counter variable is updated using the $key value. Note that $counter = $key + 1 shifts the value by one, which is not a standard method for retrieving the actual index. This example is provided to show how both variables can be accessed and manipulated simultaneously.

The output will look like this:

Key: 0, Counter: 0
Key: 1, Counter: 1
Key: 2, Counter: 2
Key: 3, Counter: 3
Key: 4, Counter: 4
Key: 5, Counter: 5
Key: 6, Counter: 6
Key: 7, Counter: 7
Key: 8, Counter: 8
Key: 9, Counter: 9

How the foreach Loop Works in PHP

The foreach loop iterates over arrays and objects that implement the Traversable interface. It is important to note that it only works with iterable data types. Attempting to use it on non-iterable types (such as integers, strings, or resources) will trigger a TypeError in PHP 8+.