Поиск

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

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

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

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/B\n"
12 . <HTML>
Посредством операторов /* и */ можно закомментировать как одну строку (в нашем примере), так и несколько, а операторами // и # только одну строку.
Программисты комментируют код поразному. Выберите понравившийся вам ме тод и придерживайтесь его в своей работе. Тот, кто программирует на JavaScript, по всей видимости, будет пользоваться операторами // и /**/. Программистам на Perl более известен символ #.

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

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