Wskaż komentarz wieloliniowy w języku PHP
A. #
B. <!-- -->
C. /* */
D. //
Pytanie z egzaminu CKE, styczeń 2021 (arkusz E.14-SG-21.01).
Komentarz wieloliniowy w PHP zapisuje się za pomocą konstrukcji /* ... */. Taki komentarz zaczyna się od /* i kończy na */, więc wszystko pomiędzy tymi znakami jest ignorowane przez interpreter PHP. To jest składnia zaczerpnięta z języków z rodziny C i w praktyce bardzo często spotyka się ją przy dłuższych opisach fragmentów programu, tymczasowym wyłączaniu kilku linii kodu albo opisywaniu bardziej złożonej logiki. Przykład: /* sprawdzamy, czy użytkownik jest zalogowany i ma odpowiednie uprawnienia */. Moim zdaniem warto jednak używać tego z głową, bo zbyt długie komentarze potrafią bardziej przeszkadzać niż pomagać. W PHP istnieje też specjalna odmiana komentarza dokumentacyjnego /** ... */, używana np. w PHPDoc do opisywania funkcji, parametrów i typów zwracanych wartości. Dobra praktyka jest taka, żeby komentarz tłumaczył dlaczego coś robimy, a nie przepisywał oczywisty kod linijka po linijce.
W PHP trzeba odróżniać komentarze jednowierszowe od wielowierszowych, bo wyglądają podobnie prosto, ale działają trochę inaczej. Znaki // oznaczają komentarz jednowierszowy, czyli interpreter ignoruje tekst od tych znaków do końca danej linii. To jest dobre do krótkich dopisków, na przykład przy przypisaniu zmiennej albo szybkim wyjaśnieniu warunku, ale nie jest to komentarz wieloliniowy. Podobnie znak # również tworzy komentarz jednowierszowy w PHP. Jest poprawny składniowo, choć w projektach webowych częściej spotyka się //, bo jest bardziej typowe dla wielu języków programowania.
Zapis <!-- --> pochodzi z HTML i służy do komentowania kodu HTML, a nie instrukcji PHP. To częsta pułapka, bo PHP bardzo często jest mieszany z HTML-em w jednym pliku, zwłaszcza w starszych aplikacjach albo prostych szablonach. Trzeba jednak pamiętać, że interpreter PHP rozumie składnię PHP tylko wewnątrz bloków <?php ... ?>. Komentarz HTML może ukryć fragment przed renderowaniem w przeglądarce, ale nie jest właściwym sposobem komentowania kodu PHP i w złym miejscu może nawet doprowadzić do błędu składni. Poprawny komentarz wieloliniowy w PHP to /* ... */. Z mojego doświadczenia najlepiej zapamiętać prostą zasadę: // i # są krótkie, na jedną linię, a /* */ obejmuje większy blok tekstu lub kodu.
Zapis <!-- --> pochodzi z HTML i służy do komentowania kodu HTML, a nie instrukcji PHP. To częsta pułapka, bo PHP bardzo często jest mieszany z HTML-em w jednym pliku, zwłaszcza w starszych aplikacjach albo prostych szablonach. Trzeba jednak pamiętać, że interpreter PHP rozumie składnię PHP tylko wewnątrz bloków <?php ... ?>. Komentarz HTML może ukryć fragment przed renderowaniem w przeglądarce, ale nie jest właściwym sposobem komentowania kodu PHP i w złym miejscu może nawet doprowadzić do błędu składni. Poprawny komentarz wieloliniowy w PHP to /* ... */. Z mojego doświadczenia najlepiej zapamiętać prostą zasadę: // i # są krótkie, na jedną linię, a /* */ obejmuje większy blok tekstu lub kodu.