Inleiding tot opmerkingen in PHP
Het woord commentaar zelf drukt zijn betekenis uit als commentaar geven op iets. Als we iets in het PHP-programmabestand becommentariëren, wordt het niet met de code gecompileerd. De compiler of de tolk zal dit gewoon negeren. Er zijn verschillende manieren waarop we commentaar kunnen geven op alles in de PHP-programmeertaal. PHP heeft ook een enkele regel en meerdere regelcommentaaropties. In de opmerking van één regel kunnen we ook de / of # gebruiken. We moeten altijd de juiste taal in de opmerking schrijven, zodat iedereen die die code bekijkt die opmerking kan lezen en begrijpen.
Syntaxis
Nogmaals, we kunnen de opmerking op de hieronder genoemde manieren in PHP gebruiken.
Enkele regel commentaar:
// This is a single-line comment
# This is a single-line comment
/*
This is a multiple line comment – line no – 1
This is a multiple line comment – line no – 2
… and so on …
*/
# this is the single-line comment
; this is a PHP.INI style commenting
Hoe werkt Comments in PHP?
Op het moment dat we de opmerking in de code schrijven, wordt deze lichter vergeleken met de werkelijke code. Als we code en de opmerking in hetzelfde bestand hebben geschreven, wordt de opmerking in dit geval niet uitgevoerd terwijl dat PHP-bestand wordt uitgevoerd. Laten we dus hetzelfde zien met een voorbeeld.
echo "This is my first PHP Program";
// this is the first program
?>
Dit geeft alleen 'Dit is mijn eerste PHP-programma' als output, niet het commentaargedeelte.
Waarom zouden we opmerkingen gebruiken?
We moeten de opmerking tussen de PHP-programmacode gebruiken om ervoor te zorgen dat we voldoende hulpopmerkingen hebben, zodat men de code gemakkelijk kan lezen en begrijpen. Als opmerking kunnen we ook voor het schrijven van het segment van de code, de datum, de wijzigingsdatum, gewijzigd door, enz. Het wordt ten zeerste aanbevolen voor een ontwikkelaar om de opmerking in de programmeercode te gebruiken, zodat dingen kunnen worden begrepen gemakkelijk met weinig of geen inspanning wanneer nodig.
Voorbeelden
Nu is het tijd om een snel voorbeeld te zien om het gedrag van de opmerking in het programma te controleren.
Voorbeeld 1
<_?phpecho "This is my first PHP Program";
// this is the first program
?>
uitgang
Voorbeeld 2
Enkele regelcommentaar in het programma
Code:
<_?phpecho date_default_timezone_get(); //to get the timezone
echo "
"; //line brea;
date_default_timezone_set('Asia/Kolkata'); // setting the timezone to Asia/Kolkata
echo date_default_timezone_get(); //to get the timezone
?>
uitgang
Voorbeeld 3
Meerregelig commentaar in het programma
Code:
<_?php/*
This is a function that will take time in minutes and will return that in hours and minutes
We use will this function further to test with some examples.
*/
function hoursandmins($minutes, $format = '%01d Hours, %02d Minutes')
(
if ($minutes < 1) (
return;
)else if($minutes<10)(
if($minutes==1)(
return '0'.$minutes.' Minute';
)
return '0'.$minutes.' Minutes';
)else if($minutes<50)(
return $minutes.' Minutes';
)
$hours = floor($minutes / 60);
$minutes = ($minutes % 60);
$format = "";
if($hours>0)(
if($hours>1)(
$format .= '%01d Hours';
)else(
$format .= '%01d Hour';
)
)
if($hours>0 && $minutes>0)(
$format .= ', ';
)
if($minutes>0)(
if($minutes>1)(
$format .= ' %02d Minutes';
)else(
$format .= ' %01d Minute';
)
)
return sprintf($format, $hours, $minutes);
)
// time to check the time in descriptive form
echo hoursandmins(20);
echo "
";
echo hoursandmins(120);
?>
uitgang
Opmerkingen die vóór een functie over die functie zijn geschreven, worden gewoonlijk de functiedocumentatie genoemd. Dus in de gegeven scenario's kunnen we deze opmerking zeggen als een functiedocument. Dit is echt leuk om de opmerking zo te gebruiken. Om het PHP-programma robuuster te maken, hebben we verschillende PHP-normen die zeggen dat we de opmerking in de functie niet moeten gebruiken, omdat we hetzelfde kunnen doen in de functiedocumentatie.
Voorbeeld 4
Gemengde opmerking
In een PHP-programmabestand kunnen we zowel PHP als HTML combineren. Gezien dit, zullen we de HTML-commentaarmethode gebruiken om het HTML-deel te becommentariëren wanneer dat nodig is, en de PHP-opmerkingen kunnen worden gebruikt voor de PHP-gerelateerde code volgens de zakelijke vereisten. We kunnen elke vorm van PHP-opmerkingen en de HTML-opmerkingen in een PHP-HTML-bestand gebruiken.
Code:
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
<_?php
PHP with HTML
echo "Hello World!"; // this is PHP comment
?>
uitgang
Voorbeeld 5
Enkele regel commentaar met #
We kunnen de commentaarregel met één regel ook met # gebruiken. Laten we een voorbeeld van dezelfde code bekijken. We kunnen zien dat deze lijn van commentaar niet zo populair is. Zeer weinig ontwikkelaars gebruiken dit soort opmerkingen. Dit wordt echt aanbevolen voor de tijd die commentaar levert voor de functiedocumentatie of de documentatie op bestandsniveau.
Code:
<_?php# $i=10;
# $j=20;
# echo $i + $j;
echo "Hello World!";
# this is PHP comment
?>
uitgang
Conclusie - Opmerkingen in PHP
Een opmerking is echt een oproep van tijd in de code. We kunnen de opmerking in ons PHP-programmabestand gebruiken. Dit zal ons helpen om de code begrijpelijker te maken. We moeten de opmerking gebruiken voordat we een functie of de klasse starten, omdat de meeste programmeertalen hun eigen codestandaard hebben. Meestal noemde de opmerking voor een functie of klasse de documentatie van die functie of de klasse.
Aanbevolen artikelen
Dit is een gids voor opmerkingen in PHP. Hier bespreken we de inleiding, hoe werkt het, waarom we opmerkingen zouden moeten gebruiken samen met voorbeelden en output. U kunt ook onze andere voorgestelde artikelen doornemen voor meer informatie–
- Python-zoekwoorden
- Array afdrukken in Java
- Wat is XPath?
- Overerving in PHP