Primera y última iteración en foreach: Trampas y soluciones en PHP

¿Por qué la pregunta «primera y última iteración de foreach» explota Stack Overflow?

Si alguna vez has escrito en PHP y has intentado añadir una clase CSS al primer elemento de una lista o insertar un separador después de cada elemento excepto el último, ya te has enfrentado a este problema. En Stack Overflow, esta pregunta ha acumulado más de 150 000 visitas y cientos de comentarios. ¿Por qué? Porque foreach es un bucle potente pero «ciego»: no sabe en qué vuelta se encuentra.

En este artículo, analizaremos 4 enfoques funcionales en PHP 8.x, desde el más ingenuo hasta el profesional. Aprenderás a evitar «hacks sucios» y a escribir código del que no te avergüences en una revisión de código.

El problema: ¿por qué foreach no conoce su número?

A diferencia de for, donde tienes un contador $i, foreach opera con el puntero interno del array. Es ideal para una iteración simple, pero cuando necesitas realizar una acción «solo para el primero» o «solo para el último» elemento, empiezan los bailes con el puntero.

Ejemplo de una tarea típica:

// Mostrar una lista de productos separados por coma, pero sin coma después del último$items = ['Leche', 'Pan', 'Huevos', 'Queso'];

foreach ($items as $item) {    echo $item . ', ';  // ¡Uy, la última coma sobra!}

Salida: Leche, Pan, Huevos, Queso, — no es bonito. Vamos a arreglarlo.

Método 1: Contador + count() — el clásico del género

La forma más obvia es crear una variable contador y compararla con el número total de elementos.

$items = ['Leche', 'Pan', 'Huevos', 'Queso'];$total = count($items);$i = 1;

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

Ventajas:

• Simplicidad y legibilidad.
• Funciona con cualquier array, incluidos los asociativos.

Desventajas:

• Hay que recordar count() e inicializar el contador.
• Si el array está vacío, $total = 0, y la primera iteración nunca ocurrirá; hay que verificarlo.
• No es adecuado para objetos Iterator (por ejemplo, generadores).

Método 2: Banderas y reset() / end() — elegancia sin contador

Se puede no contar las iteraciones, sino simplemente recordar el primer y el último elemento del array antes de iniciar el bucle.

$items = ['Leche', 'Pan', 'Huevos', 'Queso'];

$first = reset($items); // 'Leche'$last  = end($items);   // 'Queso'reset($items);          // ¡Devolvemos el puntero al inicio!

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

¡Importante! Las funciones reset() y end() modifican el puntero interno del array. Después de end(), es necesario llamar a reset(); de lo contrario, foreach no comenzará desde el principio.

Ventajas:

• No necesita contador.
• Funciona con arrays asociativos.

Desventajas:

• Peligro: si el array tiene valores duplicados (por ejemplo, dos «Queso»), el último elemento se determinará incorrectamente.
• No es adecuado para objetos Iterator.
• Requiere reinicio manual del puntero.

Método 3: array_keys() — para arrays asociativos y objetos

Si necesitas trabajar con claves (y no solo con valores) o con objetos Iterator, puedes obtener una lista de todas las claves y verificar el índice.

$items = ['a' => 'Le