Перша програма на PHP
Що ви дізнаєтесь
- Де насправді виконується PHP і чому браузер ніколи не бачить ваш код
- Як виглядає найпростіший PHP-файл і як вивести текст командою
echo - Як писати коментарі і чим коментар PHP відрізняється від коментаря HTML
- Як запустити PHP-скрипт у терміналі всередині контейнера
Де виконується PHP
У модулі 1 ми простежили шлях запиту: браузер → DNS → сервер → nginx → PHP → відповідь. Тепер подивимося уважніше на останні кроки цього ланцюжка — саме там працює код, який ви сьогодні напишете.
Коли браузер просить http://localhost:8080/index.php, nginx бачить розширення .php і не віддає файл «як є», а передає його інтерпретатору PHP (у нашому Docker Compose це окремий контейнер з PHP-FPM, який ви запускали у модулі 2). Інтерпретатор виконує код рядок за рядком, а все, що код вивів, збирається у текст відповіді. Цей текст — зазвичай HTML — nginx і повертає браузеру.
sequenceDiagram participant B as Браузер participant N as nginx participant P as PHP-FPM B->>N: GET /index.php N->>P: виконай index.php P->>P: інтерпретує код, збирає вивід P-->>N: готовий HTML N-->>B: 200 OK + HTML B->>B: будує DOM і малює сторінку
Звідси головне правило: браузер ніколи не бачить PHP-код. Він отримує лише результат його роботи. Натисніть на будь-якій PHP-сторінці Ctrl+U («Переглянути код сторінки») — там буде звичайний HTML без жодного <?php.
| PHP | JavaScript у браузері | |
|---|---|---|
| Де виконується | на сервері | на комп'ютері користувача |
| Коли | до того, як сторінку надіслано | після того, як сторінку отримано |
| Чи бачить користувач код | ні | так |
| Доступ до БД, файлів сервера | так | ні |
Важливо
Відкривати .php-файл подвійним кліком (адреса починається з file://) марно: браузер не вміє виконувати PHP і покаже сирий код або запропонує файл завантажити. PHP-сторінки відкриваємо тільки через сервер — http://localhost:8080 (порт задано в docker-compose.yml з модуля 2).
Перший скрипт
Тег <?php
Створіть у папці src/public/ (там, де лежить index.php з модуля 2) файл hello.php:
<?php
echo "Привіт, світе!";
Відкрийте http://localhost:8080/hello.php — і побачите рядок «Привіт, світе!». Розберемо, що тут відбувається:
<?php— відкриваючий тег. Усе, що після нього, інтерпретатор сприймає як PHP-код.echo— інструкція виведення: вона додає текст до відповіді сервера."Привіт, світе!"— рядок (string), текст у лапках.;— крапка з комою завершує інструкцію. Забули її — отримали помилку (типові помилки розберемо в наступній лекції).
Існує і закриваючий тег ?>. Якщо файл містить лише PHP-код, закриваючий тег прийнято не писати: випадковий пробіл чи порожній рядок після ?> потрапить у відповідь і згодом зламає роботу з cookies та сесіями (модуль 12). Цю рекомендацію закріплено в стандарті оформлення коду PSR-12.
Команда echo
echo можна викликати скільки завгодно разів — вивід просто склеюється в один текст:
<?php
echo "Перший рядок";
echo "Другий рядок\n";
echo "<p>Третій рядок в абзаці</p>";
echo "Можна ", "кілька ", "значень через кому";
Що отримає браузер (див. Ctrl+U):
Перший рядокДругий рядок
<p>Третій рядок в абзаці</p>Можна кілька значень через кому
Зверніть увагу:
- перші два рядки злиплися —
echoне додає переведення рядка автоматично; \n— символ нового рядка. У коді сторінки він видимий, але браузер нового рядка не покаже: для HTML переведення рядка — це просто пробіл;- щоб браузер справді перейшов на новий рядок, виводимо HTML-теги:
<br>,<p>,<li>тощо. PHP «не знає», що таке HTML — він просто друкує текст, а вже браузер інтерпретує теги.
Примітка
Існує ще print "текст"; — майже те саме, що echo, але приймає лише одне значення. На практиці частіше використовують echo. Документація: echo на php.net.
Запуск у терміналі
PHP вміє працювати не лише за nginx, а й як звичайна консольна програма (CLI). Це зручно для швидких експериментів. Запускаємо інтерпретатор усередині контейнера:
docker compose exec php php -v
docker compose exec php php public/hello.php
Команди виконуємо в папці проєкту, де лежить docker-compose.yml. Перша покаже версію PHP (наприклад, PHP 8.4.x (cli)), друга — виконає скрипт і надрукує в терміналі «Привіт, світе!». Робоча папка контейнера — /var/www/html (це src/ на вашому комп'ютері), тому шлях до файлу пишемо від неї: public/hello.php.
Що сервер знає про запит: $_SERVER
Коли браузер звертається до сторінки, PHP сам заповнює масив $_SERVER даними про цей запит. Два ключі знадобляться найчастіше:
$_SERVER['REQUEST_METHOD']— метод запиту:GETабоPOST(завжди великими літерами);$_SERVER['REQUEST_URI']— те, що стоїть у стартовому рядку запиту після методу: шлях і параметри після?, але без#якоря. Дляhttp://localhost:8080/request.php?page=2#tableце/request.php?page=2: якір браузер на сервер не надсилає, а хост передає окремий заголовокHost.
<p>Метод: <?= $_SERVER['REQUEST_METHOD'] ?></p>
<p>Адреса: <?= $_SERVER['REQUEST_URI'] ?></p>
Цей масив існує лише у відповіді на запит, тож у терміналі (php public/hello.php) його ключів немає. Дані до $_SERVER потрапляють від клієнта, тому виводити їх на сторінку без екранування небезпечно — про це в модулі 11.
Порада
php у команді зустрічається двічі: перше — назва сервісу з docker-compose.yml, друге — сама програма-інтерпретатор. Шлях public/hello.php рахується від робочої папки контейнера /var/www/html. Якщо бачите Could not open input file, перевірте, де ви «стоїте» (docker compose exec php pwd) і що файл лежить у src/public/. Детальніше — у документації Docker Compose.
Коментарі
Коментар — текст для людини, який інтерпретатор повністю ігнорує. Ним пояснюють навіщо написано код, тимчасово вимикають рядки під час налагодження, залишають нотатки.
<?php
// Однорядковий коментар — найпоширеніший
# Теж однорядковий, зустрічається рідше
/*
Багаторядковий коментар.
Зручно, щоб «вимкнути» кілька рядків коду.
*/
/**
* Doc-коментар: описує функції та класи.
* Повернемося до нього, коли писатимемо власні функції.
*/
echo "Коментарі не виводяться"; // коментар може стояти в кінці рядка
Doc-коментар ставлять над функцією, щоб описати, що вона робить; власні функції з'являться в модулі 9 «Функції».
Тепер важлива відмінність. В HTML теж є коментарі — <!-- ... -->. Але HTML-коментар є частиною відповіді: його отримає браузер, і будь-хто побачить його через «Переглянути код сторінки». PHP-коментар залишається на сервері і до браузера не доходить ніколи.
Увага
Ніколи не пишіть в HTML-коментарях паролі, адреси внутрішніх сервісів чи нотатки «тимчасово вимкнули перевірку». Усе це побачить кожен відвідувач.
Підсумок
- PHP виконується на сервері: nginx передає
.php-файл інтерпретатору, а браузер отримує лише результат — зазвичай HTML. - PHP-код починається з
<?php; кожна інструкція закінчується;. У файлах, що містять лише PHP, закриваючий?>не пишемо. echoдодає текст до відповіді. Нові рядки у браузері робимо HTML-тегами, а не\n.- Коментарі PHP (
//,#,/* */) до браузера не доходять, на відміну від HTML-коментарів<!-- -->.
Що далі
Наступна лекція — «Змінні і PHP всередині HTML»: зберігаємо дані у змінних і вбудовуємо PHP у сторінку.