Niets is zo vervelend om na enkele maanden een script te openen en uit te moeten zoeken wat het script doet en waarvoor je die ene regel code ook alweer had geschreven. De oplossing is het toevoegen van de nodige commentaar in je scripts. Goede commentaar kan je in staat stellen om scripts op heel korte tijd terug te begrijpen zonder de code grondig te analyseren. Zeker als je iets complexere scripts schrijft, kan een woordje uitleg handig zijn. Je kan commentaar op verschillende wijzen toevoegen:
Eén lijn commentaar:
laat je opmerkingen voorafgaan door //
Meerdere lijnen commentaar:
begin je commentaar met /* - Stop je commentaar met */
Maak volgende voorbeelden in nieuwe PHP-bestanden in de map die je gemaakt hebt in de PHP-map.
PHP-bestand CommentaarOpEenLijn.php:
<?php
// Dit is commentaar op één lijn
echo "En hier komt een heel moeilijk statement";
// Dit was een eenvoudig voorbeeld
?>
PHP-bestand CommentaarOpMeerdereLijnen.php:
<?php
/* Dit is commentaar op meerdere lijnen.
Alles wat hier staat, wordt niet verwerkt.*/
echo "En hier komt een heel moeilijk statement";
?>
Je kan commentaar ook gebruiken om tijdens het programmeren blokken code uit te schakelen. Zeker in een testfase wil je je soms concentreren op één bepaald deel van een script. Door het andere deel in commentaar te zetten, wordt die code niet langer uitgevoerd.