Перейти до змісту
Intita
Лекція · 30 хв

Перша програма на 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).

Ви відкрили hello.php подвійним кліком: в адресному рядку file:///home/olena/intita-php/src/public/hello.php, а на сторінці — сирий код <?php echo ... Де помилка?

Перший скрипт

Тег <?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
echo "Перший";
echo "Другий";
echo "Третій", "!";

Запуск у терміналі

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-коментарях паролі, адреси внутрішніх сервісів чи нотатки «тимчасово вимкнули перевірку». Усе це побачить кожен відвідувач.

У файлі page.php є коментарі: // А, /* Б */ та <!-- В --> (останній — поза блоком PHP, у HTML-частині). Який із них побачить користувач через «Переглянути код сторінки»?

Підсумок

  • PHP виконується на сервері: nginx передає .php-файл інтерпретатору, а браузер отримує лише результат — зазвичай HTML.
  • PHP-код починається з <?php; кожна інструкція закінчується ;. У файлах, що містять лише PHP, закриваючий ?> не пишемо.
  • echo додає текст до відповіді. Нові рядки у браузері робимо HTML-тегами, а не \n.
  • Коментарі PHP (//, #, /* */) до браузера не доходять, на відміну від HTML-коментарів <!-- -->.

Що далі

Наступна лекція — «Змінні і PHP всередині HTML»: зберігаємо дані у змінних і вбудовуємо PHP у сторінку.