Wskaż wszystkie znaki umożliwiające komentowanie kodu w języku PHP.
A. /* */ oraz // oraz #
B. <?php ?> oraz //
C. /* */ oraz <!-- -->
D. jedynie /* */
Pytanie z egzaminu CKE, czerwiec 2022 (arkusz EE.09-SG-22.06).
W PHP poprawny zestaw znaków do komentowania kodu to /* */, // oraz #. Komentarz blokowy /* ... */ służy do komentowania większych fragmentów kodu, nawet kilku linii naraz. Przykład: /* tu można opisać działanie funkcji albo tymczasowo wyłączyć większy kawałek kodu */. Komentarze jednoliniowe // i # działają od miejsca ich wpisania do końca linii, np. $wynik = 10; // zapisujemy wynik obliczeń albo # konfiguracja testowa. W praktyce najczęściej spotyka się // do krótkich dopisków przy instrukcjach oraz /* */ do dłuższych opisów, np. przy trudniejszym algorytmie. Z mojego doświadczenia # pojawia się rzadziej, ale nadal jest poprawnym składniowo komentarzem w PHP. Dobra praktyka jest taka, żeby komentarze wyjaśniały dlaczego coś robimy, a nie tylko przepisywały to, co i tak widać w kodzie. Warto też pamiętać, że znaczniki <?php ?> służą do otwierania i zamykania bloku PHP, a nie do komentowania.
W PHP łatwo pomylić różne znaki, bo kod PHP często jest osadzony w pliku HTML i obok siebie występują składnie kilku technologii. Sam zapis /* */ nie wyczerpuje tematu, ponieważ jest to tylko komentarz blokowy. Owszem, pozwala zakomentować dłuższy fragment programu, ale PHP obsługuje także komentarze jednoliniowe // oraz #. Jeśli ktoś używa wyłącznie komentarzy blokowych, kod może szybko zrobić się mniej czytelny, szczególnie przy krótkich dopiskach typu // walidacja formularza albo // połączenie z bazą danych. Znaczniki <?php ?> też bywają mylące, ale one nie komentują kodu. <?php otwiera sekcję kodu PHP, a ?> ją zamyka, więc parser wie, które fragmenty pliku ma wykonać jako PHP. To zupełnie inna rola niż komentarz. Podobnie <!-- --> należy do HTML i tworzy komentarz w dokumencie HTML, ale nie jest standardowym sposobem komentowania instrukcji PHP. Jeżeli wpiszesz go wewnątrz bloku PHP jak zwykłą składnię języka, dostaniesz błąd albo zachowanie niezgodne z oczekiwaniem. Typowy błąd myślowy polega na tym, że skoro PHP działa w plikach stron WWW, to wszystkie komentarze z HTML też muszą działać w PHP. Tak nie jest. Każdy język ma własną składnię, a w PHP komentarze zapisujemy przez /* */, // oraz #.