First and Last Iteration in foreach: PHP Pitfalls and Solutions

Why does the "first and last foreach iteration" question blow up on Stack Overflow?

If you've ever written PHP and tried to add a CSS class to the first item in a list or insert a separator after every item except the last, you've encountered this task. On Stack Overflow, this question has garnered over 150,000 views and hundreds of comments. Why? Because foreach is a powerful but "blind" loop: it doesn't know which iteration it's on.

In this article, we'll break down 4 working approaches for PHP 8.x, from naive to professional. You'll learn how to avoid "dirty" hacks and write code you won't be ashamed to show at a code review.

The Problem: Why doesn't foreach know its number?

Unlike for, where you have a counter $i, foreach operates on the array's internal pointer. It's ideal for simple iteration, but when you need to perform an action "only for the first" or "only for the last" element, the dance begins.

Example of a typical task:

// Output a list of items separated by commas, but no comma after the last$items = ['Milk', 'Bread', 'Eggs', 'Cheese'];

foreach ($items as $item) {    echo $item . ', ';  // Oops, trailing comma!}

Output: Milk, Bread, Eggs, Cheese, — that's not pretty. Let's fix it.

Method 1: Counter + count() — The Classic

The most obvious way is to use a counter variable and compare it to the total number of elements.

$items = ['Milk', 'Bread', 'Eggs', 'Cheese'];$total = count($items);$i = 1;

foreach ($items as $item) {    if ($i === 1) {        echo "<strong>First: $item</strong><br>";    } elseif ($i === $total) {        echo "<em>Last: $item</em><br>";    } else {        echo "$item<br>";    }    $i++;}

Pros:

• Simplicity and readability.
• Works with any arrays, including associative ones.

Cons:

• Need to remember count() and counter initialization.
• If the array is empty, $total = 0, and the first iteration will never happen — you need to check.
• Not suitable for Iterator objects (e.g., generators).

Method 2: Flags and reset() / end() — Elegance Without a Counter

Instead of counting iterations, you can simply remember the first and last elements of the array before the loop starts.

$items = ['Milk', 'Bread', 'Eggs', 'Cheese'];

$first = reset($items); // 'Milk'$last  = end($items);   // 'Cheese'reset($items);          // Reset the pointer to the beginning!

foreach ($items as $key => $item) {    if ($item === $first) {        echo "First: $item";    } elseif ($item === $last) {        echo "Last: $item";    } else {        echo "$item";    }}

Important! The reset() and end() functions change the array's internal pointer. After end(), you must call reset(), otherwise foreach will not start from the beginning.

Pros:

• No counter needed.
• Works with associative arrays.

Cons:

• Danger: if the array has duplicate values (e.g., two "Cheese" items), the last element will be identified incorrectly.
• Not suitable for Iterator objects.
• Requires manual pointer reset.

Method 3: array_keys() — For Associative Arrays and Objects

If you need to work with keys (not just values) or with Iterator objects, you can get a list of all keys and check the index.

$items = ['a' => 'Mil