Когда я рассказываю о каком-либо языке программирования, то рано или поздно я добираюсь до описания комментариев, потому что в любом языке программирования они есть и ни одна хорошая программа не может обойтись без комментариев.
В этом смысле язык РНР не является исключением. Он не такой уж простой, и в программе может быть немало мест, которые необходимо разъяснить в комментариях, чтобы другие программисты смогли понять замысел автора, да и чтобы сам автор мог понять свой замысел, когда через полгода вернётся к своему творению.
PHP предоставляет несколько способов добавления комментариев. Все эти способы были позаимствованы из языков С/С++ и оболочки Unix. Обычно используется С-стиль для помещения комментариев за пределами кода, и С++-стиль, если надо разместить комментарии в коде. Хотя, конечно, это дело вкуса.
Примеры комментариев в PHP:
Как видите, комментарии в стиле С моно разместить вокруг кода, и этот код будет работать.
Комментарии в стиле С++ или Unix начинаются с символов комментариев и продолжаются до конца строки. То есть если после // или # в той же строке вы поместите какой-то код, то этот код не будет выполнен, так как он уже будет являться не кодом, а комментарием.
Если вы встраиваете код РНР в HTML-страницу, то можно использовать закрывающий тег РНР, чтобы прервать комментарий:
<?php $d=13; #Устанавливаем $d в 13 ?> Переменная d=<?php echo $d; ?>
Здесь у нас всё в одной строке, однако комментарий заканчивается там, где заканчивается участок кода на РНР (там, где будет встречен тег ?>). Дальше уже идёт HTML-код (точнее, просто текст на HTML-странице), поэтому комментарий РНР заканчивается. Точно так же это будет работать и с комментарием в стиле С++.
А вот комментарий в стиле С не будет прерван закрывающим тегом PHP, потому что он многострочный и требует закрывающих символов:
С первого раза это может быть не очень понятно, но постарайтесь разобраться. На самом деле здесь всё просто.
Также комментарии могут быть вложенными. Например, в комментарий стиля С могут быть вложены комментарии других стилей. То есть вы легко можете закомментировать блок кода, который уже содержит комментарии:
Но, как видите, вложенные комментарии в стиле С недопустимы, так как в этом случае последние символы */ будут лишними. В этом случае надо либо эти символы (*/) убрать, либо в качестве вложенных использовать другой вид комментариев.
На этом всё. Подписывайтесь на канал, чтобы ничего не пропустить.