- Как написать свою первую программу на PHP
- Требования
- Написание программы «Hello, World!»
- Как запустить программу «Hello, World!»
- Расширение кода PHP
- Добавление комментариев в PHP
- Документирование с помощью DocBlocks
- Заключение
- PHP Hello World
- PHP Hello World on the web browser
- PHP Hello World on the command line
- Summary
Как написать свою первую программу на PHP
«Hello, World!» – это классическая тестовая программа в мире разработки ПО. Ее по традиции пишут, чтобы убедиться, что в установке все работает должным образом. С нее чаще всего начинается изучение нового языка – она отлично иллюстрирует основной синтаксис языков программирования.
Это руководство поможет вам написать программу «Hello, World!» на PHP. Вы узнаете, как правильно открывать и закрывать блоки PHP в своем коде, а также научитесь использовать различные типы комментариев.
Требования
На вашем компьютере вам понадобится установка PHP и локальная среда разработки. Создать все необходимые для работы условия вам поможет наше руководство Настройка локальной среды разработки PHP 7.4.
Написание программы «Hello, World!»
Давайте приступим к написанию программы «Hello, World!». С помощью командной строки откройте текстовый редактор, например nano, и создайте новый файл:
Как только текстовый файл откроется в окне терминала, введите код нашей программы:
Давайте рассмотрим компоненты этого кода по порядку.
Весь PHP-код помещен в блок, который начинается с .
echo – это языковая конструкция. За ключевым словом echo следует аргумент – список выражений, разделенных запятыми. С помощью echo вы можете сказать PHP, что ему нужно отображать или выводить все, что находится между ключевым словом echo и конечной точкой с запятой.
В нашем случае между ними находится последовательность символов, заключенная в двойные кавычки – “Hello, World!”. Любые символы, заключенные в кавычки, называются строкой.
После написания программы нажмите клавишу X, удерживая CTRL, чтобы выйти из nano. Когда будет предложено сохранить файл, нажмите Y.
Как только вы выйдете из nano, вы попадете обратно в свою оболочку.
Наша простая программа «Hello, World!» готова.
Как запустить программу «Hello, World!»
Теперь программа готова к запуску. Чтобы запустить ее, используйте команду php с именем файла программы:
Запустив hello.php, вы получите в терминале следующий результат:
Давайте рассмотрим более подробно, что именно делала программа.
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 уникальным, – это теги и аннотации. Этот раздел дает возможность кратко и организованно предоставить метаинформацию о заданном элементе. Теги могут, например, описывать тип информации, которую принимает или возвращает метод или функция. также этот раздел может содержать подробную информацию об авторе или авторских правах. Вот пример такого комментария:
Лучше стремиться писать ясный и простой для понимания код. Но если нужно пояснить какое-то место в коде, обязательно используйте комментарии – они помогут описать дополнительный контекст, улучшить понимание кода и логику, лежащую в основе кода.
Заключение
В этом руководстве вы написали простую программу «Hello, World!» на PHP. Также мы поговорили о блоках кода PHP, тегах и видах комментариев.
PHP Hello World
Summary: in this tutorial, you’ll learn how to execute a script that outputs the Hello, World! message on the web browser and command line.
PHP Hello World on the web browser
First, open the folder htdocs under the xampp folder. Typically, it locates at C:\xampp\htdocs .
Second, create a new folder called helloworld .
Third, create a new file called index.php under the helloworld folder and place the following code in the file:
"en"> "UTF-8"> "viewport" content="width=device-width, initial-scale=1.0">echo 'Hello, World!'; ?>
Code language: PHP (php)
The code in the index.php file looks like a regular HTML document except the part .
The code between the opening tag is PHP:
echo 'Hello, World!'; ?>Code language: HTML, XML (xml)This PHP code prints out the Hello, World message inside the h1 tag using the echo statement:
When PHP executes the index.php file, it evaluates the code and returns the Hello, World! message.
Fourth, launch a web browser and open the URL:
http://localhost:8080/helloworld/Code language: JavaScript (javascript)If you see the following on the web browser, then you’ve successfully executed the first PHP script:
If you view the soure code of the page, you’ll see the following HTML code:
html> html lang="en"> head> meta charset="UTF-8"> meta name="viewport" content="width=device-width, initial-scale=1.0"> title>PHP - Hello, World! title> head> body> h1>Hello, World! h1> body> html>Code language: HTML, XML (xml)PHP Hello World on the command line
First, open the Command Prompt on Windows or Terminal on macOS or Linux.
Second, navigate to the folder c:\xampp\htdocs\helloworld\.
Third, type the following command to execute the index.php file:
c:\xampp\htdocs\helloworld>php index.phpCode language: CSS (css)You’ll see the HTML output:
html lang="en"> head> meta charset="UTF-8"> title>PHP - Hello, World! title> head> body> h1>Hello, World! h1> body> html>Code language: HTML, XML (xml)Since the terminal doesn’t know how to render HTML to web, it just shows the pure HTML code.
To simplify the output, you can use the following code in the index.php :
echo 'Hello, World!';Code language: HTML, XML (xml)If you execute the script again:
c:\xampp\htdocs\helloworld>php index.phpCode language: CSS (css)and you’ll see the following output:
When you embed PHP code with HTML, you need to have the opening tag . However, if the file contains only PHP code, you don’t need to the closing tag ?> like the index.php above.
Summary
- Place the PHP code between to mix PHP code with HTML.
- Use the echo construct to output one or more strings to the screen.