Commenti

Cosa sono i commenti

Un commento è testo scritto per chi legge il codice. PHP lo ignora e non lo esegue.

I commenti servono a spiegare una scelta, ricordare un dettaglio o chiarire un passaggio non immediato.

Commenti su una riga

Usa // per scrivere un commento breve.

<?php
// Salviamo il nome dell'utente
$nome = "Giulia";

echo $nome;

PHP esegue $nome = "Giulia"; ed echo $nome;, ma ignora la riga che comincia con //.

Commenti su più righe

Usa /* e */ quando il commento occupa più righe.

<?php
/*
Questo esempio calcola il prezzo finale
partendo da prezzo iniziale e sconto.
*/
$prezzo = 30;
$sconto = 5;

echo $prezzo - $sconto;

Quando usare i commenti

Un buon commento spiega il perché, non ripete l’ovvio.

<?php
// Applichiamo lo sconto solo agli ordini sopra i 50 euro
if ($totale > 50) {
    $totale = $totale - 10;
}

Questo commento è utile perché spiega la regola.

Quando evitarli

Questo commento non aiuta:

<?php
// Stampa il nome
echo $nome;

Il codice è già chiaro. Se devi commentare ogni riga, forse puoi scegliere nomi migliori o dividerlo in parti più piccole.

Commentare una scelta

Un commento è prezioso quando spiega una regola che dal codice non si vede subito.

<?php
$totale = 62;

// La spedizione e gratuita dagli ordini sopra i 50 euro
if ($totale > 50) {
    $costoSpedizione = 0;
} else {
    $costoSpedizione = 4.90;
}

Qui il commento non ripete if ($totale > 50). Spiega la regola del negozio.

Usare i commenti mentre studi

Mentre impari, puoi usare i commenti per dividere un esercizio in passaggi.

<?php
// 1. Salvo i dati iniziali
$prezzo = 20;
$sconto = 5;

// 2. Calcolo il totale
$totale = $prezzo - $sconto;

// 3. Mostro il risultato
echo $totale;

Così il programma si legge come una piccola storia. Con il tempo userai meno commenti, perché i nomi delle variabili e delle funzioni renderanno il codice più chiaro.

Prova tu

Prendi un esercizio breve e aggiungi tre commenti: dati iniziali, calcolo, risultato. Poi rileggilo e cancella i commenti che ripetono soltanto quello che il codice dice già.