Изучаем комментарии в PHP
Комментарии в PHP при выполнении скрипта игнорируются препроцессором, и нужны только для людей. Разработчики часто пренебрегают комментированием кода.
Среди программистов бытует мнение, что они вспомнят, как работает код, и через шесть месяцев и через год. Еще одна причина не оставлять комментарии — уверенность в том, что код настолько хорошо написан, что он ясен и без пояснений. Но нужно помнить, что может потребоваться продолжать поддерживать созданные скрипты PHP долгое время после написания.
Не менее важная причина комментирования кода — убедиться, что последователи поддерживают или добавляют функциональность вашему творению. Они также получат пользу от чтения оставленных комментариев.
PHP предоставляет два способа комментирования: один — для однострочных комментариев, а второй — для многострочных. PHP заимствует синтаксис комментариев из C , C++ и Java . Так что, если вы знакомы с ними, то сюрпризов для вас не будет.
Однострочные комментарии в PHP
Перед комментариями, которые находятся на одной строке, в PHP ставятся два символа косой черты ( // ).
Следующий пример содержит однострочный PHP комментарий в коде:
Однострочный комментарий может находиться на отдельной строке, или добавляется в конец строки кода:
В примере, приведенном выше, препроцессор PHP выполнит функцию echo и проигнорирует все, что расположено после // .
Однострочные комментарии также применяются, чтобы временно убрать строки кода из потока выполнения. Например, следующее изменение предыдущего примера приведет к тому, что PHP проигнорирует всю команду echo во время выполнения:
Многострочные комментарии в PHP
Многострочные комментарии для сайта PHP обернуты разделителями / * и * /. Знак /* обозначает начало блока комментариев, а */ указывает на его конец. Следующий пример демонстрирует использование многострочного комментирования:
Многострочные комментарии полезны, когда заметки, которые вы хотите вставить в код, занимают более одной строки. Возможность помечать блоки строк как комментарии позволяет избежать использования однострочного комментария в начале каждой строки.
Другое полезное применение многострочных комментариев — временное отключение блоков кода PHP . Распространенная практика — написать PHP-скрипт и размышлять, можно ли переписать его так, чтобы он стал более эффективным. В данной ситуации можно закомментировать старый фрагмент кода, чтобы он больше не выполнялся, и написать новый. Если окажется, что новый код хуже оригинала, то можно в PHP удалить комментарии и новый код. А затем раскомментировать старый, чтобы вернуть его в поток выполнения.
Итоги
И однострочные, и многострочные комментарии можно легко добавить в PHP- код , используя специальный синтаксис. Постарайтесь выработать привычку комментировать свой код.
Теперь, когда мы усвоили некоторые базовые понятия PHP , настало время изучить основы этого языка программирования, начиная с введения в переменные PHP .
Пожалуйста, опубликуйте ваши отзывы по текущей теме материала. Мы очень благодарим вас за ваши комментарии, дизлайки, отклики, подписки, лайки!
Пожалуйста, опубликуйте ваши мнения по текущей теме материала. За комментарии, отклики, лайки, дизлайки, подписки огромное вам спасибо!
Комментарии
PHP поддерживает комментарии в стиле 'C', 'C++' и оболочки Unix (стиль Perl). Например:
Однострочные комментарии идут только до конца строки или текущего блока PHP-кода, в зависимости от того, что идет перед ними. Это означает, что HTML-код после // . ?> или # . ?> БУДЕТ напечатан: ?> завершает режим PHP и возвращает режим HTML, а // или # не могут повлиять на это. Если включена директива asp_tags, то аналогичное поведение будет и с // %> и # %>. Однако, тег </script> не завершает режим PHP в однострочном комментарии.
'C'-комментарии заканчиваются при первой же обнаруженной последовательности */. Убедитесь, что вы не вкладываете друг в друга 'C'-комментарии. Очень легко допустить эту ошибку при комментировании большого блока кода.
Как закомментировать строку с HTML, PHP, CSS кодом?
Представляю Вашему вниманию мини пост, в котором я покажу, как закомментировать HTML, PHP, CSS строчки кода.
Для начала, немного вводной информации.
Закомментировать HTML код, означает, его временное отключение.
Чтобы Вам было более понятно о чём вообще идёт речь, приведу один из примеров использования этой функции.
Допустим, решили Вы на своём сайте или блоге применить, какой-то новый виджет. Нашли подходящий код в Интернете, открыли в редакторе один из файлов Вашей темы оформления и внесли своё новшество. Но, вдруг зазвонил телефон и Вас срочно вызывают на деловую встречу.
Протестировать виджет времени нет, а оставлять, как есть, тоже не вариант. Конечно, можно его удалить и смело идти на встречу, но есть вероятность того, что Вы его потеряете, или забудете где нашли.
Чтобы избежать ненужных проблем, достаточно закомментировать HTML , PHP , CSS строчки кода и спокойно удалиться по своим делам. Благодаря этой функции, куски кода останутся на месте, а посетители раньше времени ничего не увидят.
Как закомментировать HTML, PHP, CSS.
Для того, чтобы закомментировать HTML строчки кода, оберните их символами – « <!—КОД—> ».
Закомментировать PHP, можно, используя символы – « /* и */ ».
В случае с CSS, применяются те же символы, что и у PHP — « /* и */ ».
По возвращению к редактированию Ваших файлов, просто удалите поставленные символы и спокойно занимайтесь новыми разработками.
Возможно, что Вас ещё заинтересует:
Надеюсь, что Вам была полезна информация о том, как закомментировать HTML!
Друзья, в конце поста находиться любопытное видео, советую посмотреть. Небольшая промывка мозга, но над некоторыми вещами стоит задуматься!