Który zapis definiuje w języku PHP komentarz wieloliniowy?
A. //
B. <!-- -->
C. #
D. /* */
Pytanie z egzaminu CKE, czerwiec 2021 (arkusz EE.09-SG-21.06).
W PHP komentarz wieloliniowy zapisuje się za pomocą pary znaków /* oraz */. Wszystko, co znajduje się między tymi znacznikami, jest ignorowane przez interpreter PHP, więc nie zostanie wykonane jako kod programu. Taki komentarz przydaje się, gdy trzeba opisać większy fragment logiki, tymczasowo wyłączyć kilka linii kodu albo zostawić dłuższą notatkę dla innych programistów. Przykład praktyczny: /* sprawdzamy, czy użytkownik jest zalogowany i ma odpowiednie uprawnienia */. Moim zdaniem to jedna z tych prostych rzeczy, które naprawdę pomagają utrzymać porządek w plikach PHP. Warto jednak pamiętać, że komentarze blokowe nie powinny zastępować czytelnego kodu. Dobra praktyka branżowa jest taka: kod ma być zrozumiały sam z siebie, a komentarz ma wyjaśniać trudniejszy zamiar, algorytm albo nietypową decyzję. W PHP spotyka się też komentarze dokumentacyjne zaczynające się od /**, używane np. przez narzędzia generujące dokumentację, ale podstawowy komentarz wieloliniowy to właśnie /* */.
W PHP trzeba odróżniać komentarze jednowierszowe od wieloliniowych, bo składnia wygląda podobnie prosto, ale działa inaczej. Zapis // jest poprawny w PHP, jednak komentuje tylko treść od miejsca wystąpienia tych znaków do końca bieżącej linii. Nadaje się świetnie do krótkich dopisków, na przykład przy pojedynczej instrukcji, ale nie obejmie automatycznie kilku kolejnych linii kodu. Podobnie działa znak #, który w PHP również może rozpoczynać komentarz jednowierszowy. Często myli się to z komentarzem blokowym, bo oba zapisy służą do ukrywania tekstu przed interpreterem, ale zakres ich działania jest inny. Z kolei zapis <!-- --> należy do HTML, a nie do składni PHP. W pliku .php można oczywiście mieć kod HTML, ale wewnątrz bloku <?php ... ?> taki zapis nie jest poprawnym komentarzem PHP i może doprowadzić do błędu składniowego. To typowa pułapka, bo PHP bardzo często miesza się z HTML-em w jednym pliku. Komentarz wieloliniowy w PHP musi zaczynać się od /* i kończyć na */. Trzeba też uważać, żeby nie zagnieżdżać takich komentarzy jeden w drugim, bo to robi bałagan i zwykle kończy się problemem z interpretacją kodu.