Uso dei commenti in PHP

Uso dei commenti in PHP
I commenti vengono utilizzati con qualsiasi codice sorgente per spiegare correttamente la funzionalità del codice. Ogni linguaggio di programmazione utilizza una particolare sintassi per aggiungere un commento nel codice sorgente. Il commento non viene letto dall'interprete o dal compilatore del linguaggio di programmazione. Il programmatore non ha davvero bisogno di aggiungere commenti nel codice, ma ci sono due vantaggi nell'uso di un commento nel codice. Uno dei vantaggi è rendere il codice leggibile per gli altri di comprendere correttamente il codice e un altro vantaggio è aiutare il programmatore a ricordare la funzionalità del codice dopo molto tempo quando il codice richiede modifiche. La sintassi dei commenti utilizzata in PHP è simile ad altri linguaggi di programmazione standard come C, C ++, Java, ecc. Il commento può essere una linea singola e multipla. In questo tutorial sono visualizzati i commenti a linea singola e multilinea.

Commento a linea singola

Il commento a linea singola può essere utilizzato nel codice PHP utilizzando una sintassi diversa. In questo tutorial sono mostrati due tipi di commento a linea singola del codice PHP. Uno è la sintassi dei commenti C ++/Java e un altro è la sintassi del commento Shell. I due sintassi dell'utilizzo dei commenti a linea singola in PHP sono mostrati in questa sezione del tutorial.

Esempio-1: commenti a linea singola usando la sintassi C ++/Java

I caratteri a doppio hash ('//') vengono utilizzati per commentare una singola riga nello script PHP. Nello script seguente, i cinque commenti a linea singola vengono utilizzati per spiegare il codice. Qui vengono dichiarati valori a tre corde e questi vengono combinati in seguito in un'altra variabile. Viene aggiunto un commento a linea singola per ogni affermazione omessa dall'interprete al momento dell'esecuzione.

// Imposta il primo valore di stringa
$ str1 = "benvenuto";
// Imposta il secondo valore di stringa
$ str2 = "to";
// Imposta il terzo valore stringa
$ str3 = "LinuxHint";
// combina la stringa con lo spazio
$ str = $ str1."".$ STR2."".$ STR3;
// stampa la stringa combinata
eco "

$ str

";
?>

Produzione:

Verrà visualizzato il seguente output dopo aver eseguito il codice. L'output mostra i valori combinati di $ STR1, $ STR2 e $ STR3. Tutti i commenti a linea singola sono stati ignorati dall'interprete.

Esempio 2: commenti a linea singola usando la sintassi shell

Il simbolo "#" viene utilizzato per il commento a linea singola nello script Shell che è supportato da PHP. Il seguente script PHP calcola se l'anno in corso è un anno di salto o no. La funzione personalizzata isleap () viene utilizzata qui per calcolare se l'anno in corso è un anno di salto o no. Il commento a linea singola viene utilizzato nel codice per rendere lo script più leggibile per i lettori. Qui, la funzione Date () viene utilizzata per leggere l'anno in corso menzionato nel commento. Successivamente, la funzione mktime () viene utilizzata per verificare se l'anno è un anno di salto o no. Se l'anno è un anno di salto, la funzione mktime () restituirà 1 e il carattere di formato 'l' viene utilizzato nella funzione data () per l'anno di salto. I commenti necessari a linea singola vengono utilizzati nello script.

#Leggi l'anno in corso dalla data del sistema
$ anno = data ("y");
#Call la funzione isleap () e testare il valore di ritorno
If (isleap ($ anno))

eco "

L'anno, $ l'anno è un anno di salto.

";

altro

eco "

L'anno, L'anno $ non è un anno di salto.

";

#Defina una funzione per controllare l'anno di salto
funzione isleap ($ anno)

#Find out l'anno è saltare o no
restituzione (data ('l', mktime (0, 0, 0, 1, 1, $ anno)) == 1);

?>

Produzione:

Verrà visualizzato il seguente output dopo aver eseguito il codice. L'output mostra che l'anno in corso, 2020, è un anno di salto e tutti i commenti a linea singola sono stati ignorati dall'interprete.

Commento multilinea

Un commento multilinea viene utilizzato per aggiungere un lungo commento di testo. Se il programmatore deve spiegare in dettaglio la funzione del codice per una migliore comprensione, allora può aggiungere un commento multi-line per quel codice. Il '/*' viene utilizzato all'inizio del commento e '*/' viene utilizzato alla fine del commento. Questo tipo di commento multi-line è utilizzato in qualsiasi linguaggio di programmazione standard, come Java, C ++, ecc. Un commento multilinea viene utilizzato principalmente all'inizio di qualsiasi script per fornire informazioni dettagliate su script, sceneggiatore, versione, collegamento del codice sorgente, ecc.
Come vengono utilizzati i commenti multilinea in PHP nel seguente esempio:

Esempio-3: commento multi-riga usando '/ *… */'

Nello script seguente, vengono utilizzati tre commenti multi-line per spiegare il codice. Il primo commento descrive la funzionalità dello script. Il secondo commento spiega la funzione della funzione rand (). Il terzo commento spiega lo scopo della funzione isprime (). Un numero casuale tra 1 e 100 verrà generato ogni volta che lo script esegue e la funzione isprime () scoprirà se il numero è primo o no. Se la funzione restituisce vera, il numero è primo. Altrimenti, il numero non è primo.

/* Il seguente script testerà un numero particolare è
Prime o no Prime usando una funzione personalizzata
*/
/* Assegna un numero casuale tra 1 e 100 utilizzando
Funzione PHP incorporata Rand ()
*/
$ NUMBER = RAND (1.100);
// Controlla che il numero è PRIME o NOT PRIME
if (isprime ($ numero))
eco "

Il numero $ è un numero primo.

";
altro
eco "

Il numero $ non è un numero primo.

";
/* La funzione restituirà 1 se il numero casuale generato
Il numero casuale è primo e restituisce 0 se il numero non lo è
Prime */
funzione isprime ($ numero)
if ($ numero == 1)
restituzione 0;
per ($ i = 2; $ i

Produzione:

L'output dello script varierà in ogni esecuzione a causa del numero casuale. Il seguente output è apparso dopo aver eseguito il codice per la prima volta e verrà modificato nella prossima esecuzione. Se il numero casuale generato è primo, allora isprime () restituirà 1 e se il numero casuale generato non è primo, allora isprime () restituirà 0.

Conclusione

Ogni script standard contiene commenti per aiutare il lettore a comprendere correttamente il codice. Molti nuovi programmatori non aggiungono commenti nel loro script che rendono il codice difficile da capire per altri programmatori. Quindi, quando scrivi qualsiasi script, è necessario aggiungere commenti per ogni affermazione.