Komentarze są bardzo ważnnym elementem tworzenia zaawansowanych aplikacji w PHP - to właśnie dzięki nim możemy szybko odnaleźć konkretne miejsce w kodzie, a dzięki informacji, które możemy w nich zamieścić szybko przypomnimy sobie do czego dany kod służy.

Wraz z powiększaniem się naszych prac, a zapewniam, że nawet największy pokazany w tym kursie kod będzie zaledwie kroplą w morzu prawdziwych skryptów, będziemy powoli zapominać co służy do czego, co zamyka dany nawias/klamerka itp. itd.

Po to właśnie zostały stworzone komentarze – poprzedzone specjalnym kodem informacje, które są odrzucane przez interpreter PHP, tzn. nie są przez niego zauważane, które może zobaczyć tylko osoba dysponująca źródłem skryptu (nie przerobionym przez interpreter i wysłany do przeglądarki).

Są dwa sposoby na komentowanie naszych prac. Pierwszym poznanym komentarzem będzie komentarz umieszczony w jednej linii.


Komentarze jednolinijkowe


Aby zapisać jednolinijkowy komentarz musimy jakiś tekst, lub ewentualnie inny ciąg znaków poprzedzić dwoma slashami - //:

<?php

// deklarujemy zmienną o nazwie zmienna, która będzie później używana

$zmienna = 6;

// i wyświetlamy ją wraz z pozostałą częścią tekstu

echo "0-700-123-45$zmienna";

?>

Komentarze wielolinijkowe


Komentarz jest jednolinijkowy, co oznacza, że zaczyna się on w miejscu podwójnego slasha i trwa do końca danej linii. Prace możemy komentować także w wielu liniach, taki komentarz zaczynamy znaczkiem /*, a kończymy inwersją - */. Możemy rozwlec go na kilka linijek np.:

<?php

$zmienna = 6;

/* deklarujemy zmienną o nazwie zmienna, która będzie później używana

i wyświetlamy ją wraz z pozostałą częścią tekstu */

echo "0-700-123-45$zmienna";

?>

Chociaż ten komentarz powszechnie jest używany w wielu linijkach możemy umieścić go w jednej wraz z innymi interpretowanymi poleceniami PHP np.:

<?php

$cyfra = "a"; /* no comments */ $litera = "1";

echo "Moje mieszkanie to $litera$cyfra";

?>

O komentarzach to już wszystko, ale pozostała jeszcze tylko jedna uwaga...

Uwaga: za pomocą komentarzy możemy łatwo wyłączać część kodu, bez zbędnego wycinania kodu, a następnie gubieniu go (przez proste pomyłki), co oznacza utratę pracy np.:

<?php

/* gdyby nie ten komentarz skrypt działałby trochę normalniej

$zmienna = "Tekst";

*/

echo "Wartość zmiennej to: $zmienna";

?>