Introduzione
Quando si parla di strutture di controllo in PHP, spesso si pensa subito a if, switch o ai cicli base come for e foreach. Un sotto-argomento molto utile, però, è la gestione dei cicli annidati, cioè l’uso di più cicli uno dentro l’altro per lavorare con dati strutturati come matrici, tabelle, cataloghi, calendari o risultati raggruppati.
Questo tema è pratico perché nei progetti reali capita spesso di dover attraversare dati complessi: ad esempio una lista di ordini con i relativi prodotti, una griglia di disponibilità, oppure un array multidimensionale proveniente da un database o da un’API. In questi casi, sapere come controllare correttamente il flusso dei cicli evita errori, migliora la leggibilità del codice e riduce i problemi di manutenzione.
In questo tutorial vedremo come usare i cicli annidati in PHP in modo professionale, con un esempio concreto e commentato. L’obiettivo non è solo far “funzionare” il codice, ma scriverlo in modo pulito, comprensibile e facile da estendere.
Codice completo
Immaginiamo di avere un elenco di ordini. Ogni ordine contiene più prodotti e vogliamo stampare un riepilogo ordinato con il totale per ogni ordine e il totale generale.
<?php
$ordini = [
[
´id´ => 101,
´cliente´ => ´Luca Bianchi´,
´prodotti´ => [
[´nome´ => ´Mouse wireless´, ´prezzo´ => 25.90, ´quantita´ => 2],
[´nome´ => ´Tastiera meccanica´, ´prezzo´ => 79.50, ´quantita´ => 1],
]
],
[
´id´ => 102,
´cliente´ => ´Sara Conti´,
´prodotti´ => [
[´nome´ => ´Monitor 24 pollici´, ´prezzo´ => 149.99, ´quantita´ => 1],
[´nome´ => ´Cavo HDMI´, ´prezzo´ => 9.90, ´quantita´ => 3],
[´nome´ => ´Supporto monitor´, ´prezzo´ => 34.00, ´quantita´ => 1],
]
],
[
´id´ => 103,
´cliente´ => ´Marco Rossi´,
´prodotti´ => [
[´nome´ => ´Webcam Full HD´, ´prezzo´ => 49.90, ´quantita´ => 1],
]
]
];
$totaleGenerale = 0;
foreach ($ordini as $ordine) {
$totaleOrdine = 0;
echo "<h3>Ordine #" . $ordine[´id´] . " - " . $ordine[´cliente´] . "</h3>";
echo "<ul>";
foreach ($ordine[´prodotti´] as $prodotto) {
$subtotale = $prodotto[´prezzo´] * $prodotto[´quantita´];
$totaleOrdine += $subtotale;
echo "<li>";
echo htmlspecialchars($prodotto[´nome´]) . " - ";
echo $prodotto[´quantita´] . " x €" . number_format($prodotto[´prezzo´], 2, ´,´, ´.´) . " = ";
echo "€" . number_format($subtotale, 2, ´,´, ´.´);
echo "</li>";
}
echo "</ul>";
$totaleGenerale += $totaleOrdine;
echo "<p><strong>Totale ordine:</strong> €" . number_format($totaleOrdine, 2, ´,´, ´.´) . "</p>";
}
echo "<h3>Riepilogo finale</h3>";
echo "<p><strong>Totale generale:</strong> €" . number_format($totaleGenerale, 2, ´,´, ´.´) . "</p>";
?>Spiegazione
Il codice usa due cicli foreach annidati. Il primo attraversa l’elenco degli ordini, mentre il secondo scorre i prodotti contenuti in ciascun ordine.
1. Struttura dei dati
La variabile $ordini contiene un array multidimensionale. Ogni elemento rappresenta un ordine con:
- id: identificativo dell’ordine
- cliente: nome del cliente
- prodotti: elenco dei prodotti acquistati
Questa struttura è molto comune nelle applicazioni reali, perché riflette bene dati gerarchici e relazioni uno-a-molti.
2. Ciclo esterno
Il primo foreach attraversa ogni ordine. Per ogni iterazione inizializza $totaleOrdine a zero, così il conteggio del totale è separato per ciascun ordine.
Questa è una buona pratica importante: quando usi cicli annidati, le variabili di accumulo devono essere definite nel livello giusto, altrimenti rischi di mescolare i risultati tra un gruppo e l’altro.
3. Ciclo interno
Il secondo foreach scorre i prodotti dell’ordine corrente. Per ogni prodotto calcola il subtotale moltiplicando prezzo e quantità.
Il subtotale viene poi sommato a $totaleOrdine. In questo modo, alla fine del ciclo interno, otteniamo il totale completo dell’ordine.
4. Totale generale
Dopo aver elaborato tutti i prodotti di un ordine, il valore di $totaleOrdine viene aggiunto a $totaleGenerale. Così otteniamo sia il riepilogo per singolo ordine sia il totale complessivo di tutti gli ordini.
5. Output sicuro e leggibile
Nel codice troviamo htmlspecialchars() quando stampiamo il nome del prodotto. Anche se in questo esempio i dati sono statici, nella pratica potrebbero arrivare da un database o da un form. Escapare l’output è una buona abitudine per evitare problemi di sicurezza e visualizzazione.
Inoltre, number_format() rende i valori monetari più leggibili, con due decimali e separatori italiani.
Best practice
Gestire cicli annidati non significa solo scrivere due foreach uno dentro l’altro. Ci sono alcune regole pratiche che aiutano a mantenere il codice pulito e affidabile.
- Limita la profondità dei cicli: se hai tre o più livelli annidati, valuta di estrarre parte della logica in funzioni dedicate.
- Usa nomi chiari per le variabili: $ordine, $prodotto, $totaleOrdine sono molto più leggibili di nomi generici.
- Inizializza gli accumulatori nel punto corretto: ogni gruppo deve avere il proprio totale, altrimenti i dati si mescolano.
- Proteggi l’output HTML: se stampi dati dinamici, usa htmlspecialchars() per evitare problemi di sicurezza.
- Preferisci la semplicità: se una struttura dati è troppo complessa, può essere utile rielaborarla prima del rendering.
- Separa calcolo e visualizzazione: in applicazioni più grandi, conviene calcolare i totali in una funzione e lasciare al template solo la stampa.
Un errore comune è inserire troppa logica dentro il ciclo interno. Questo rende il codice difficile da leggere e da testare. Meglio mantenere il blocco di iterazione essenziale e spostare eventuali trasformazioni in funzioni separate.
Riepilogo
I cicli annidati sono una delle applicazioni più concrete delle strutture di controllo in PHP. Servono per attraversare dati gerarchici e produrre risultati aggregati in modo ordinato.
In questo tutorial hai visto come:
- strutturare un array multidimensionale con ordini e prodotti
- usare due foreach annidati per elaborare dati complessi
- calcolare subtotali, totali per gruppo e totale generale
- stampare l’output in modo leggibile e sicuro
- applicare best practice utili nei progetti reali
Se impari a gestire bene i cicli annidati, potrai lavorare con molti scenari comuni: report, tabelle, liste raggruppate, calendari, statistiche e molto altro. È una competenza fondamentale per scrivere PHP solido e facile da mantenere.
Approfondisci con risorse ufficiali
- PHP Manual - foreach: documentazione ufficiale sul ciclo foreach
- PHP Manual - arrays: guida completa sugli array in PHP, inclusi quelli multidimensionali
- PHP Manual - number_format: funzione utile per formattare numeri e importi
- PHP Manual - htmlspecialchars: funzione fondamentale per la sicurezza dell’output HTML
- PHP Manual - control structures: panoramica ufficiale sulle strutture di controllo del linguaggio