HTML в PHP — Веб-разработка на PHP
Главный секрет PHP заключается в том, что сам язык — шаблонизатор. Если посмотреть на другой язык, в его файлах нельзя увидеть ничего похожего на теги .
В PHP любой файл с кодом — это шаблон. Причем этот шаблон не имеет структуры, как бывает в некоторых шаблонизаторах.
Мы можем создать PHP-файл, написать любой текст вне тегов и запустить код на выполнение. При этом он не упадет с указанием синтаксической ошибки.
hi i am the template Запуск этого кода выведет весь текст на экран:
То же самое касается HTML, так как это всего лишь текст. Достаточно в любом PHP-файле добавить немного HTML и запустить его, как он будет выведен на экран:
href="/lessons">Lessons
Запуск этого кода выведет весь текст на экран:
Такое поведение языка существует исключительно ради создания сайтов. Если запустить веб-сервер в директории с этим файлом index.php, то при обращении к этому сайту мы получим вывод как в терминале. Это значит, что мы можем заменить такой код:
echo 'hello, world
'; hello, world
Отсюда следует важный вывод. Любой PHP-файл – это обычный текстовый файл со вставками PHP-кода с помощью тегов . Любой текст, написанный внутри него, отдается в вывод как есть, будь то браузер или запуск в командной строке.
Теперь добавим немного PHP. Шаблон становится шаблоном, когда внутри него появляется подстановка данных. Принцип работы: в любом месте шаблона вставляются теги , внутри которых можно написать код. Фактически мы имеем дело с обычной строковой интерполяцией:
href="/lessons"> echo 'Lessons'; ?>
Добавим немного программирования. Запуск следующего кода вернет такой же результат, что и код выше:
$name = 'Lessons'; ?> href="/lessons"> echo $name; ?> В этом примере мы добавили один блок сверху файла, внутри которого создали переменную. Затем мы использовали ее в другой вставке.
Все содержимое файла находится в одном пространстве и блоки кода, определенные дальше по тексту, имеют доступ к данным предыдущих блоков. Что важно, подстановка данных из кода происходит только в том случае, если этот код выполняет печать:
$name = 'Lessons'; $id = 23; ?> href="/lessons/ echo $id; ?>"> echo $name; ?> Вывод на экран после запуска:
Для удобства вставки кода в HTML PHP предлагает альтернативный синтаксис для стандартных конструкций языка. Например, для вставки значения используется сокращенная версия тега начала PHP-кода: ?> . Она отличается от полной тем, что вместо
Сокращенная вставка
$name = 'Lessons'; ?> href="/lessons/ 23 ?>"> $name ?> If
if ($a === 5) : ?> A is equal to 5 endif; ?> Switch
switch ($foo) : ?> case 1: ?> . endswitch; ?> Foreach
foreach ($users as $user) : ?> $user->getName() ?> endforeach; ?>
С одной стороны поддержка CGI внутри самого языка позволяет начать делать сайт «на коленке» без особых знаний программирования и HTTP, что многие и делают. С другой — PHP толкает к созданию не поддерживаемого кода, который не может никто прочитать кроме автора.
Upload your files enctype="multipart/form-data" action="upload.php" method="POST"> Upload your file type="file" name="uploaded_file"> /> type="submit" value="Upload"> if (!empty($_FILES['uploaded_file'])) $path = "uploads/"; $path = $path . basename( $_FILES['uploaded_file']['name']); if (move_uploaded_file($_FILES['uploaded_file']['tmp_name'], $path)) echo "The file " . basename( $_FILES['uploaded_file']['name']) . " has been uploaded"; > else echo "There was an error uploading the file, please try again!"; > >
Такой способ программирования возможен только в PHP, потому что только PHP это сразу и язык, и шаблонизатор, и CGI-скрипт. При таком способе организации кода сайт быстро начинает представлять из себя мешанину HTML и PHP.
Если количество разных страниц сайта достигнет хотя бы десятка, то поддержка уже станет намного сложнее. Безопасность такой шаблонизации находится на нуле (см. XSS ).
Также PHP не поддерживает макеты — специализированные шаблоны, содержащие обвязку сайта, в которую вставляется HTML конкретного обработчика.
Открыть доступ
Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно
- 130 курсов, 2000+ часов теории
- 1000 практических заданий в браузере
- 360 000 студентов
Наши выпускники работают в компаниях:
Первая страница на PHP
Создайте файл с именем hello.php в корневом каталоге веб-сервера ( DOCUMENT_ROOT ) и запишите в него следующее:
Пример #1 Первый скрипт на PHP: hello.php
Откройте данный файл в браузере, набрав имя вашего веб-сервера и /hello.php . При локальной разработке эта ссылка может быть чем-то вроде http://localhost/hello.php или http://127.0.0.1/hello.php , но это зависит от настроек вашего сервера. Если всё настроено правильно, этот файл будет обработан PHP и браузер выведет следующий текст:
Тестируем PHP Привет, мир!
Эта программа чрезвычайно проста, и для создания настолько простой странички даже необязательно использовать PHP. Все, что она делает, это вывод Hello World , используя инструкцию PHP echo . Заметьте, что файл не обязан быть выполняемым или ещё как-то отличаться от других файлов. Сервер знает, что этот файл должен быть обработан PHP, так как файл обладает расширением «.php», о котором в настройках сервера сказано, что подобные файлы должны передаваться PHP. Рассматривайте его как обычный HTML-файл, которому посчастливилось заполучить набор специальных тегов (доступных также и вам), способных на кучу интересных вещей.
Если у вас этот пример не отображает ничего или выводит окно загрузки, или если вы видите весь этот файл в текстовом виде, то, скорее всего, ваш веб-сервер не имеет поддержки PHP или был сконфигурирован неправильно. Попросите вашего администратора сервера включить такую поддержку. Предложите ему инструкцию по установке: раздел Установка данной документации. Если же вы разрабатываете скрипты на PHP дома (локально), то также прочтите эту главу, чтобы убедиться, что вы все настроили верно. Убедитесь также, что вы запрашиваете файл у сервера через протокол http. Если вы просто откроете файл из вашей файловой системы, он не будет обработан PHP. Если проблемы всё же остались, не стесняйтесь попросить помощи одним из » множества доступных способов получения поддержки по PHP.
Цель примера — показать формат специальных тегов PHP. В этом примере мы использовали . Таким образом можно где угодно «запрыгивать» и «выпрыгивать» из режима PHP в HTML файле. Подробнее об этом можно прочесть в разделе руководства Основной синтаксис.
Замечание: Замечание о переводах строк
Переводы строк немногое означают в HTML, однако считается хорошей идеей поддерживать HTML в удобочитаемом виде, перенося его на новую строку. PHP автоматически удаляет перевод строки, идущий сразу после закрывающего тега ?> . Это может быть чрезвычайно полезно, если вы используете множество блоков PHP-кода или подключаете PHP-файлы, которые не должны ничего выводить. В то же время, это может приводить в недоумение. Можно поставить пробел после закрывающего тега ?> и тогда пробел будет выведен вместе с переводом строки, или же вы можете специально добавить перевод строки в последний вызов echo/print из блока PHP-кода.
Замечание: Пара слов о текстовых редакторах
Существует множество текстовых редакторов и интегрированных сред разработки (IDE), в которых вы можете создавать и редактировать файлы PHP. Список некоторых редакторов содержится в разделе » Список редакторов PHP. Если вы хотите порекомендовать какой-либо редактор, посетите данную страницу и попросите добавить редактор в список. Использование редактора с подсветкой синтаксиса может быть очень большим подспорьем в вашей работе.
Замечание: Пара слов о текстовых процессорах
Текстовые процессоры (StarOffice Writer, Microsoft Word, Abiword и др.) в большинстве случаев не подходят для редактирования файлов PHP. Если вы всё же хотите использовать какой-либо из них для тестового скрипта, убедитесь, что сохраняете файл как простой текст (plain text), иначе PHP будет не в состоянии прочесть и запустить ваш скрипт.
Теперь, когда вы успешно создали работающий PHP-скрипт, самое время создать самый знаменитый PHP-скрипт! Вызовите функцию phpinfo() и вы увидите множество полезной информации о вашей системе и настройке, такой как доступные предопределённые переменные, загруженные PHP-модули и параметры настройки. Уделите некоторое время изучению этой важной информации.
Пример #2 Получение информации о системе из PHP
Начало
Привет! Здесь собраны уроки по веб-программированию (разработке сайтов). Уроки рассчитаны на начинающих, которые, может, и слова «HTML» в жизни ни разу не слышали. Уроки разбиты на уровни, первый — основы PHP.
Уроки простые, в каждом теория и задачки, которые нужно решать для ее закрепления. Присоединяйся!
Требуемые знания: умение включать компьютер и пользоваться браузером. Ноутбук/айпад/планшет/смартфон тоже подходят, если в них есть интернет.
Зачем это нужно? На PHP (после того, как ты дойдешь до определенного уровня) можно делать сайты и онлайн-игры, вконтакте и фейсбук написаны на нем.
Немного о PHP
Что такое ? Язык программирования.
Что такое ? Это текст, в котором записана последовательность команд. Программист пишет скрипт, а интерпретатор PHP читает написанный скрипт и выполняет записанные в нем команды (собственно потому он и называется интерпретатором). Иногда текст скрипта называют . Что может делать скрипт? Да все, что угодно. Профит!
Где взять интерпретатор PHP? Надо что-то настраивать и устанавливать? Нет, пока мы обойдемся без этого и будем запускать программы с помощью сайта ideone.
Каким образом пишется программа? Любым, который нравится программисту. Так как код — это обычный текст, то можно использовать даже блокнот, однако делать так не стоит. Лучше скачать продвинутый редактор вроде Notepad++ для Windows (бесплатно) или Sublime Text (платно). Если тебе нужно еще больше возможностей, можно взять IDE (среду разработки), например Netbeans PHP (бесплатно) или PHPStorm (платно). Продвинутые редакторы подсвечивают код разными цветами, поддерживают автодополнение и содержат много других полезных функций. Для первых уроков хватит сайта ideone.com, но далее стоит скачать и освоить хотя бы Notepad++.
Ideone сломался и не открывается? Используй другие похожие сервисы: http://phptester.net/
http://codepad.org/
http://www.runphponline.com/
http://sandbox.onlinephpfunctions.com/
https://phpkiss.com/
https://repl.it/languages/php
http://phpfiddle.org/ (сложный).
Итак, заходи на сайт http://ideone.com/ . Там ты можешь набрать свой скрипт, нажать кнопку, и увидеть результат его работы. То, что ты туда вводишь, отправляется на их сервер, интерпретатор PHP исполняет этот код, а тебе выводится результат.
Первая программа
Давай не будем откладывать пpактику в долгий ящик, и сделаем задание:
W1. Следуя инструкциям на картинке, набери и выполни свою первую программу на PHP. Программа должна вывести какой-нибудь текст.
Если вместо результата ты видишь сообщения об ошибках, проверь свой код — может, ты кавычку не такую написал или где-то букву пропустил? Сообщения об ошибках выглядят обычно так:
Разберемся, как работает эта программа
В первой и последней строках есть код:
Это специальные (теги), чтобы отметить начало и конец блока PHP-кода. Интерпретатор выполняет лишь команды, заключенные внутри них. Если ты забудешь маркер в конце скрипта можно не писать — все равно же конец, но я написал, чтобы ты знал, что он есть.
Далее идет инструкция error_reporting(-1); . Эта команда включает отображение всех возможных предупреждений (без нее выводятся не все). Поскольку это уроки для начинающих, то, чем строже проверяется твой код, тем лучше для тебя — ошибки не останутся незамеченными. Пиши эту команду в начало всех своих скриптов!
Обрати внимание! После каждой инструкции идет точка с запятой. Её нельзя пропускать. Правила PHP разрешают писать инструкции либо подряд, в одну строчку, либо каждую на новой строке. Если писать все в одну строку, код станет нечитаемым и непонятным, потому пиши каждую инструкцию на отдельной строке.
Кроме этого, в нашей программе есть еще одна инструкция:
echo «Hello out there»;
Команда echo просто выводит то, что ей передали — в данном случае строку «Hello out there» . Строки в PHP надо заключать в одиночные или двойные кавычки (позже мы узнаем, в чем разница), чтобы отличать их от команд. Не перепутай кавычки с какими-то похожими символами, они (и одиночные, и двойные) расположены на клавише рядом с Enter:
Что еще умеет выводить команда echo?
С ее помощью можно выводить и считать числа, например, так (не забудь точку с запятой в конце строки):
echo (20 + 30) * 5 / 2;
Эта команда напечатает число 125 (можешь проверить: http://ideone.com/FF7QLs). В математических выражениях можно использовать скобки () , + , — , умножение (обозначается звездочкой * ), деление (обозначается слешем / , не перепутай с обратным слешем «\» или вертикальной чертой «|»). Дробные числа, например, «три с половиной», в программировании пишутся через точку (а не через запятую): 3.5 .
Еще один оператор, который можно использовать в выражениях — это % , и он обозначает не «процент», а остаток от деления чисел и используется так:
Если вдруг ты забыл, что такое остаток от деления: чтобы найти остаток от деления 15 на 6, мы вычитаем из числа 15 число 6, пока остаток не станет меньше 6. В данном случае, получается ответ 3 . Оператор % используется в таких случаях:
- Чтобы найти одну или несколько последних цифр числа, можно взять остаток от деления на 10, 100, 1000, и т.д: echo 17856 % 100 выведет 56 .
- Чтобы узнать четное число или нет, можно взять остаток от деления на 2: четные числа дают 0, а нечетные 1 в остатке.
Попробуй найти ошибку. Если никак-никак не можешь, то просто удали часть программы и попробуй снова, таким образом ты найдешь строку, в которой ошибка, и сможешь более внимательно ее изучить. Или сотри все и напиши заново. Также можно попробовать погуглить текст ошибки.
Надеюсь, ты понял, как работает echo . Математика закончилась, давай почитаем про сервера.
А как PHP используется на сайтах?
Если кратко: когда пользователь набирает у себя в браузере адрес сайта, например, http://example.com, браузер отправляет на сервер (на котором работает сайт) специальный HTTP-запрос и там запускается PHP-скрипт. Скрипт выводит текст на языке HTML, он отправляется в браузер и тот отображает его в виде красивой странички. Если подробнее — смотри картинку ниже.
Вообще, PHP скрипты можно использовать не только на сервере. Можно, например, скачать и установить PHP на компьютер и запускать скрипт в командной строке (это такое черное окошко, в котором можно набирать команды и которое в Windows можно вызвать, набрав Пуск→Выполнить→ cmd . А на маках и linux оно называется «терминал»).
Есть такие способы.
- Можно написать скрипт и запустить из командной строки. То есть, делаешь Пуск→Выполнить→cmd , набираешь хитрую команду вроде c:\php\php.exe d:\myscript.php и запускается интерпретатор PHP, который начинает читать и выполнять то, что записано в скрипте myscript.php. Естественно, предварительно ты должен скачать и установить сам PHP.
- Если у тебя есть доступ к серверу (VPS например), то ты можешь загрузить скрипт туда и запустить его там. По похожему принципу работает ideone: набранный тобой текст отправляется на сервер, где и выполняется.
- Если ты хочешь сделать сайт на основе PHP, то тут все чуть сложнее. Ты покупаешь домен, хостинг (детали — как-нибудь попозже), настраиваешь их и закачиваешь по SFTP или FTP свои скрипты на него (если мама пока не дает тебе денег на хостинг, ты можешь найти бесплатный хостинг или установить на своем компе сервер вроде WAMP или Denver, но тогда твой сайт будешь видеть только ты). После того, как ты закачал свои скрипты на хостинг (или запустил и настроил Denver), ты набираешь в браузере адрес веб-сервера. Твой браузер соединяется с сервером, отправляет ему запрос. Веб-сервер, получив запрос, находит твой скрипт и запускает его. Все, что выведет скрипт, сервер отправляет назад в браузер, и пользователь таким образом, видит результат работы скрипта. Скрипт (если он правильно написан) может вернуть пользователю картинку, простой текст, или специальный текст в , который отобразится в браузере в виде красивой страницы с картинками.
Как работают скрипты на сайте 
Где прочесть официальный мануал на русском по PHP?
В этом мануале полное описание правил языка, команд и функций от авторов PHP. Заучивать мануал наизусть, естественно, не надо, просто надо знать его адрес и в случае каких-то сомнений прояснять с его помощью непонятные моменты.
Куда вводить код? Что надо скачать? Читай первый урок.
Есть вопросы? Задай гуглу или автору.
Нравится урок? Лайкай, репости, приглашай друзей, пости котов и Канако, шли добра, решай задачи, помогай новичкам! Кнопок для лайка нет, кто хочет зарепостить, всегда может сделать это ручками.
Как связаться с автором? Я хочу переодеть его в платье школьницы и жениться на нем. Ящик codedokode (кот) gmail.com ждет ваших писем. А вконтактик и фейсбучек ждут ваших лайков. Но ответ на банальные вопросы лучше искать в Гугле или на stackoverflow.
Я решил задачку. Молодец, делай следующий урок
Ideone не работает!11 Ну так открой Гугл и найди сайты вроде https://repl.it/languages/php , http://phptester.net/ , http://sandbox.onlinephpfunctions.com/ , http://codepad.org/ или http://www.runphponline.com/ . Не ленись.
Почему так много рекламы? Всю рекламу на сайте ставит юкоз (бесплатный хостинг же), а не я.
На сайте установлена система Google Analytics (и еще несколько аналогичных систем от юкоза). Данные о твоем IP-адресе, посещаемых страницах, времени посещения отправляются в Google Corporation, США. Хочу знать, кто и зачем сюда заходит. Поверь, другие сайты делают точно так же. Все сайты пишут логи.
- Начало
-
- Переменные
- Условия и игра в кубики
- Циклы и айфон в кредит
- Массивы и рулетка
- Строки, хакеры и шифровки
- Функции и новый айпад
- Регулярные выражения
- Повторим?
- Бонусные задачки
- Пасты и ООП
- Учим сами
Что это?
Это сайт, где собраны простые уроки по языку программирования PHP. Даже если ты никогда не слышал слова «программирование» и учишься на филолога, ты можешь попробовать их сделать.
Скачивать и устанавливать тоже ничего не надо, делать уроки можно даже с айпада или ведроида.
Как написать свою первую программу на PHP
«Hello, World!» – это классическая тестовая программа в мире разработки ПО. Ее по традиции пишут, чтобы убедиться, что в установке все работает должным образом. С нее чаще всего начинается изучение нового языка – она отлично иллюстрирует основной синтаксис языков программирования.
Это руководство поможет вам написать программу «Hello, World!» на PHP. Вы узнаете, как правильно открывать и закрывать блоки PHP в своем коде, а также научитесь использовать различные типы комментариев.
Требования
На вашем компьютере вам понадобится установка PHP и локальная среда разработки. Создать все необходимые для работы условия вам поможет наше руководство Настройка локальной среды разработки PHP 7.4.
Написание программы «Hello, World!»
Давайте приступим к написанию программы «Hello, World!». С помощью командной строки откройте текстовый редактор, например nano, и создайте новый файл:
Как только текстовый файл откроется в окне терминала, введите код нашей программы:
php echo "Hello, World!"; ?>
Давайте рассмотрим компоненты этого кода по порядку.
Весь PHP-код помещен в блок, который начинается с .
echo – это языковая конструкция. За ключевым словом echo следует аргумент – список выражений, разделенных запятыми. С помощью echo вы можете сказать PHP, что ему нужно отображать или выводить все, что находится между ключевым словом echo и конечной точкой с запятой.
В нашем случае между ними находится последовательность символов, заключенная в двойные кавычки – “Hello, World!”. Любые символы, заключенные в кавычки, называются строкой.
После написания программы нажмите клавишу X, удерживая CTRL, чтобы выйти из nano. Когда будет предложено сохранить файл, нажмите Y.
Как только вы выйдете из nano, вы попадете обратно в свою оболочку.
Наша простая программа «Hello, World!» готова.
Как запустить программу «Hello, World!»
Теперь программа готова к запуску. Чтобы запустить ее, используйте команду php с именем файла программы:
Запустив hello.php, вы получите в терминале следующий результат:
Hello, World!
Давайте рассмотрим более подробно, что именно делала программа.
PHP следующим образом выполнил строку echo “Hello, World!”;
- Он вызывал языковую конструкцию echo.
- Строковое значение Hello, World! было передано этой конструкции. В данном примере строка Hello, World! также является аргументом, поскольку это значение передается другой части кода, например конструкции или функции.
Кавычки по обе стороны от Hello, World! не выводятся на экран: они используются, чтобы сообщить PHP, что этот фрагмент кода содержит строку. Проще говоря, кавычки обозначают начало и конец строки.
Поскольку программа была успешно обработана, вы можете быть уверены, что PHP установлен правильно и что синтаксис программы не содержит ошибок. Прежде чем углубляться в сам код, давайте подробнее рассмотрим блок кода PHP.
Расширение кода PHP
Всё, что в файле .php находится за пределами тегов PHP, рассматривается как HTML или обычный текст. Изначально язык PHP был написан для расширения функциональных возможностей HTML. Имея это в виду, вы можете поместить в файл несколько блоков кода PHP. При этом все, что находится за пределами блоков, будет отображаться как HTML или обычный текст.
Обновите свой файл hello.php:
Hi 8host echo "Hello, World!"; ?> How are you doing? echo "Cloudy!";
Сохраните файл и перезапустите его. Вы получите такой результат:
Hi 8host Hello, World! How are you doing? Cloudy!
Если вы внимательно посмотрите на код, вы заметите, что Hi 8host и How are you doing? находятся за пределами блоков кода PHP и поэтому при запуске программы отображаются как простой текст.
Теперь наш файл содержит два блока кода PHP. Первый блок включает в себя как начальный и конечный теги, а второй блок, находящийся в конце файла, не включает закрывающий тег. С чем это связано?
Закрывающий тег блока (?>) включать не нужно, если блок идет в конце файла. Если файл заканчивается блоком кода PHP, этот блок рекомендуется не закрывать тегом. Дело в том, что любой символ, идущий после закрывающего тега (даже пробел), будет выводиться на экран в виде HTML или обычного текста, а это может вызвать неожиданные последствия для работы приложения. Например, функции типа перенаправления не будут обрабатываться, если что-нибудь было выведено в браузер. Если ваш файл содержит только код PHP, никогда не включайте закрывающий тег PHP.
По мере усложнения кода полезно оставлять заметки для себя и других. Это можно сделать с помощью комментариев.
Добавление комментариев в PHP
Комментарий в коде – это строка, которая не будет выполняться как часть программы. Ее единственная цель – предоставить информацию человеку, который смотрит на код. Иногда код читается гораздо медленнее, чем пишется – многих разработчиков до сих пор шокирует эта разница во времени. Следовательно, очень важно, чтобы код был как можно более легким для чтения. Этого можно добиться несколькими способами:
- Следуйте стандартам написания кода. Стандарт – это набор руководящих принципов и передовых практик для четкой и последовательной организации и форматирования кода. В PHP наиболее часто применяются стандарты PHP-FIG (Framework Interop Group).
- Быстро читаемый код лучше, чем быстро написанный код. Используйте описательные переменные вместо сокращений. Думайте не о том, сколько строк кода вы напишете, а о том, сколько времени потребуется, чтобы посторонний разработчик прочитал эти строки и понял, что делает эта программа.
- Пишите комментарии. Хотя это не обязательно, если вы следовали двум предыдущим пунктам. В целом же ваш код должен быть понятным другим людям, а комментарии объясняют, почему что-то происходит именно так, а не иначе.
В PHP есть два типа комментариев: однострочные и многострочные. Однострочные комментарии могут начинаться в любом месте строки и заканчиваться либо в конце строки, либо в конце блока кода (в зависимости от того, что наступит раньше).
Наиболее распространенный способ начать однострочный комментарий – поставить двойной слеш (//), хотя PHP также распознает диез (#) как начало однострочного комментария. Добавьте в наш файл пару однострочных комментариев, чтобы потренироваться:
Hi 8host echo "Hello"; //, World!"; ?> How are you doing? echo "Cloudy!"; // other options: Flying along
Сохраните и запустите файл. Вы увидите:
Hi 8host Hello How are you doing? Cloudy!
Первый комментарий начинается в середине строки. Заключительная кавычка и точка с запятой идут после «Hello», а остальная часть строки закомментирована. Комментирование одной или нескольких строк кода часто используется при отладке – это позволяет проверить, как программа реагирует на удаление определенных элементов кода.
Второй комментарий предлагает дополнительный вариант ответа. Следующим шагом развития вашего проекта может быть возможность выбирать ответ из списка предложенных вариантов. В таком случае комментарий используется как напоминание о других опциях.
Многострочные комментарии начинаются с символов /* и заканчиваются */. Интерпретатор PHP проигнорирует любой текст или код внутри этих символов. Чтобы потренироваться, давайте превратим последнюю строку в многострочный комментарий:
Hi 8host echo "Hello"; //, World!"; ?> How are you doing? echo "Cloudy!"; /* When responding with one of a number of answers, here are some other options: * Flying along * Fantastic * Going with the wind * I am a breath of fresh air * I have my head in the clouds */
Многострочные комментарии дают возможность поместить больше деталей, чтобы еще немного упростить понимание кода и его предназначения. Наш многострочный комментарий включает разрывы строк и использует символ звездочки (*) в качестве маркера списка. Комбинация */ – это закрывающий тег, он указывает на конец нашего блока комментариев.
Документирование с помощью DocBlocks
Существует особый тип многострочного комментария, который называется DocBlock. Это уникальный способ документирования функциональности конкретного файла, класса, метода или других структурных элементов кода. DocBlock начинается и заканчивается, как и любой другой многострочный комментарий (/ * * /), однако он предназначен для предоставления конкретных деталей о конкретном элементе. Эти сведения не только предоставляют обзор кода для разработчиков, но также могут использоваться редактором кода (или IDE).
DocBlock состоит из нескольких частей. Первая часть – это краткое описание элемента (либо более подробное описание, если требуется больше контекста).
Последний раздел, который и делает DocBlock уникальным, – это теги и аннотации. Этот раздел дает возможность кратко и организованно предоставить метаинформацию о заданном элементе. Теги могут, например, описывать тип информации, которую принимает или возвращает метод или функция. также этот раздел может содержать подробную информацию об авторе или авторских правах. Вот пример такого комментария:
/** * DocBlock example * * @author 8host */ .
Лучше стремиться писать ясный и простой для понимания код. Но если нужно пояснить какое-то место в коде, обязательно используйте комментарии – они помогут описать дополнительный контекст, улучшить понимание кода и логику, лежащую в основе кода.
Заключение
В этом руководстве вы написали простую программу «Hello, World!» на PHP. Также мы поговорили о блоках кода PHP, тегах и видах комментариев.