Добавление комментариев в сценарий

Каждый программист понимает, что делать заметки для себя это спасательное
средство, когда вы возвращаетесь к проекту для изменения, копирования или от
ладки фрагментов кода после большого перерыва. Использование заметок, или
комментариев, помогает вспомнить, что вы думали в тот момент. Это не всегда
просто сделать несколько месяцев спустя. При обработке сценария компьютер
игнорирует комментарии, а РНР поддерживает три метода их создания

Есть два способа закомментировать строку кода, поставив символы / / или #
в самое начало строки. Их можно также использовать для вставки коммента
рия после строки РНР:

Print ("Hello."); // Просто приветствие.

Комментирование строки кода

  1. Откройте сценарий first.php в текстовом редакторе.
  2. Перед командой печати на строке 8 введите символ / / или # (листинг 1.6).
  3. Сохраните сценарий, загрузите его на сервер и просмотрите страницу
    с помощью браузера (рис).

Листинг 1.6 т Использование символа // или # перед строкой кода означа
ет, что эта строка закомментирована и не будет обработана сервером.

1 . <HTML>
2. <HEAD>
3.<TITLE>First PHP Script</TITLE>
4.</HEAD>
5. <BODY>
6. <?PHP
7.
8.// print ("<BxCENTER>Hello, world!</CENTERx/B>n" ) ;
9.
10. ?>
11. </BODY>
12. </HTML>

Если все работает правильно, вы ничего не увидите в браузере. Не беспо
койтесь, это не ошибка! Браузер не напечатал фразу «Hello, world!», так как не
было команды на это действие (мы ведь закоментировали инструкцию с помо
щью символа / / или #).
Используя обозначения /* до, а */ после сегмента кода, вы даете команду
серверу проигнорировать все, что попало между этими скобками, от слова до
нескольких строк.

Комментирование нескольких строк кода

  1. Откройте сценарий first.php в текстовом редакторе.
  2. Удалите операторы # и / / перед командой print ( ) .
  3. В любом месте перед командой print ( ) на строке 8, но после открываю
    щего PHPтэга (<?РНР) на строке 6 наберите символ /*.
  4. В любом месте после команды print ( ) на строке 8 (после точки с запя
    той), но до закрывающего РНРтэга (?>) на строке 10 введите символ */
    (листинг 1.7).
  5. Сохраните сценарий, загрузите его на сервер и просмотрите страницу
    с помощью браузера (рис).

Листинг 1.7 т Может показаться избыточным использование операторов
/ * * / для комментирования одной строки кода, хотя в этом нет ничего страш
ного, а полученный результат тот же, что и при работе с операторами # или / /
(рис.).


1 . <HTML>
2 . <HEAD>
3. <TITLE>First PHP Script</TITLE>
4. </HEAD>
5 . <?PHP
6. /*
7.print ("
8. */
9. ?>
10. </BODY>
11. <BxCENTER>Hello, world!</CENTERx/Bn"
12 . <HTML>

Посредством операторов /* и */ можно закомментировать как одну строку
(в нашем примере), так и несколько, а операторами // и # только одну строку.
Программисты комментируют код поразному. Выберите понравившийся вам ме
тод и придерживайтесь его в своей работе. Тот, кто программирует на JavaScript,
по всей видимости, будет пользоваться операторами // и /**/. Программистам
на Perl более известен символ #.

Обратите внимание на то, что для комментариев кода в РНР нельзя использовать
символы комментариев HTML (<! и —>). РНР можно использовать для печати
этих элементов на странице, в этом случае комментарий появится в исходном тек
сте HTML на клиентском компьютере (но не в окне браузера). Комментарии РНР
никогда не видны на мониторе пользователя.

Так как закомментированный в РНР текст не пересылается в браузер (рис. 1.10), это
хорошее место для хранения замечаний, видимых только программисту.
В хороших текстовых редакторах, таких как BBEdit, закомментированный код вы
деляется цветом (рис. 1.11). Очень полезная функциональность при работе с боль
шими сценариями.

Понравилась статья? Поделиться с друзьями:
Добавить комментарий

;-) :| :x :twisted: :smile: :shock: :sad: :roll: :razz: :oops: :o :mrgreen: :lol: :idea: :grin: :evil: :cry: :cool: :arrow: :???: :?: :!: