Bruk av kommentarer i PHP

Bruk av kommentarer i PHP
Kommentarene brukes med hvilken som helst kildekode for å forklare kodenes funksjonalitet på riktig måte. Hvert programmeringsspråk bruker en bestemt syntaks for å legge til en kommentar i kildekoden. Kommentaren blir ikke lest av tolk eller kompilator av programmeringsspråket. Koderen trenger egentlig ikke å legge til kommentarer i koden, men det er to fordeler ved å bruke en kommentar i koden. En fordel er å gjøre koden lesbar for andre å forstå koden riktig, og en annen fordel er å hjelpe koderen til å minne funksjonaliteten til koden etter lang tid når koden krever modifisering. Kommentarsyntaksen som brukes i PHP ligner på andre standardprogrammeringsspråk som C, C ++, Java, etc. Kommentaren kan være en enkeltlinje og flerlinje. Hvordan enkeltlinje- og flerlinjekommentarer kan brukes i PHP-kode vises i denne opplæringen.

Enkeltlinje kommentar

Enkeltlinjekommentar kan brukes i PHP-kode ved å bruke forskjellige syntaks. To typer av enkeltlinjekommentaren til PHP-kode vises i denne opplæringen. Den ene er C ++/Java Kommentar syntaks, og en annen er Shell Commentar Syntax. De to syntaksene ved bruk av en-linjekommentarer i PHP vises i denne delen av opplæringen.

Eksempel-1: Kommentarer med en linje ved bruk av C ++/Java Syntax

Double Hash ('//') tegn brukes til å kommentere en enkelt linje i PHP -skriptet. I det følgende skriptet brukes de fem enkeltlinjekommentarene til å forklare koden. Her er tre-strengsverdier erklært, og disse kombineres senere til en annen variabel. En enkeltlinjekommentar blir lagt til for hver uttalelse som er utelatt av tolken på utførelsestidspunktet.

// angi den første strengverdien
$ str1 = "Velkommen";
// angi den andre strengverdien
$ str2 = "til";
// angi den tredje strengverdien
$ str3 = "Linuxhint";
// kombinere strengen med plass
$ str = $ str1."".$ str2."".$ str3;
// Skriv ut den kombinerte strengen
ekko "

$ str

";
?>

Produksjon:

Følgende utgang vises etter å ha utført koden. Utgangen viser de kombinerte verdiene på $ str1, $ str2 og $ str3. Alle kommentarer med en linje har blitt ignorert av tolken.

Eksempel-2: Kommentarer med en linje ved hjelp av skallsyntaks

'#' -Symbolet brukes til enkeltlinjekommentar i skallskriptet som støttes av PHP. Følgende PHP -skript beregner om inneværende år er et sprangår eller ikke. Island () tilpasset funksjon brukes her for å beregne om inneværende år er et sprangår eller ikke. Enkeltkommentaren brukes i koden for å gjøre skriptet mer lesbar for leserne. Her brukes datoen () -funksjonen til å lese inneværende år som er nevnt i kommentaren. Deretter brukes mkTime () -funksjonen for å sjekke om året er et sprangår eller ikke. Hvis året er et sprangår, vil MkTime () -funksjonen returnere 1, og formatkarakteren 'L' brukes i datoen () -funksjonen for LEAP -året. De nødvendige enkeltlinjekommentarene brukes i skriptet.

#LEAD inneværende år fra systemdatoen
$ år = dato ("y");
#Kall islap () -funksjonen og test returverdien
If (islap ($ år)))

ekko "

Året, $ år er sprangår.

";

ellers

ekko "

Året, $ år er ikke sprangår.

";

#Defin en funksjon for å sjekke sprangåret
Funksjon Islap ($ år)

#Finn ut året er sprang eller ikke
Retur (dato ('l', mktime (0, 0, 0, 1, 1, $ år)) == 1);

?>

Produksjon:

Følgende utgang vises etter å ha utført koden. Produksjonen viser at inneværende år, 2020, er et sprangår, og alle kommentarer med en linje har blitt ignorert av tolk.

Multi-linje kommentar

En kommentar med flere linjer brukes til å legge til en lang tekstkommentar. Hvis koderen trenger å forklare kodenes funksjon i detalj for bedre forståelse, kan han/hun legge til en multi-line kommentar for den koden. '/*' Brukes ved starten av kommentaren, og '*/' brukes ved avslutningen av kommentaren. Denne typen multi-linjekommentar brukes på ethvert standard programmeringsspråk, for eksempel Java, C ++, etc. En multi-linjekommentar brukes hovedsakelig i begynnelsen av et hvilket som helst skript for å gi detaljert informasjon om manus, manusforfatter, versjon, lenke til kildekoden osv.
Hvordan flere linjer kommentarer brukes i PHP vises i følgende eksempel:

Eksempel-3: Multi-line kommentar ved bruk av '/ *… */'

I det følgende skriptet brukes tre flerlinjekommentarer til å forklare koden. Den første kommentaren beskriver funksjonaliteten til skriptet. Den andre kommentaren forklarer funksjonen til RAND () -funksjonen. Den tredje kommentaren forklarer formålet med ISPrime () -funksjonen. Et tilfeldig tall mellom 1 til 100 vil bli generert hver gang skriptet utføres, og ISPrime () -funksjonen vil finne ut om tallet er førsteklasses eller ikke. Hvis funksjonen kommer tilbake, er tallet Prime. Ellers er ikke tallet førsteklasses.

/* Følgende skript vil teste et bestemt nummer er
først eller ikke prime ved hjelp av en tilpasset funksjon
*/
/* Tilordne et tilfeldig tall mellom 1 til 100 ved å bruke
Innebygd PHP-funksjon rand ()
*/
$ nummer = rand (1100);
// sjekk nummeret er førsteklasses eller ikke prime
if (ISPrime ($ nummer))
ekko "

$ nummer er et primtall.

";
ellers
ekko "

$ nummer er ikke et primtall.

";
/* Funksjonen vil returnere 1 hvis det genererte tilfeldige tallet
Tilfeldig antall er førsteklasses og returnerer 0 hvis nummeret ikke er
prime */
funksjon ISPRIME ($ nummer)
if ($ nummer == 1)
retur 0;
for ($ i = 2; $ i

Produksjon:

Utgangen fra skriptet vil variere i hver utførelse på grunn av det tilfeldige tallet. Følgende utdata dukket opp etter å ha utført koden for første gang, og den vil bli endret i neste utførelse. Hvis det genererte tilfeldige tallet er prime, vil ISPrime () returnere 1, og hvis det genererte tilfeldige tallet ikke er prime, vil ISPrime () returnere 0.

Konklusjon

Hvert standardskript inneholder kommentarer for å hjelpe leseren til å forstå koden riktig. Mange nye kodere legger ikke til kommentarer i skriptet sitt som gjør koden vanskelig å forstå for andre kodere. Så når du skriver noe skript, bør du legge til kommentarer for hver uttalelse.