Шлях запиту, шляхи до файлів і IDE
Що ви дізнаєтесь
- Як запит до
http://localhost:8080/проходить крізь контейнериweb(nginx) іphp(PHP-FPM) - Де лежать файли проєкту на вашому комп'ютері і де — всередині контейнерів
- Чому сторінки кладемо лише в
src/public/і що означають 404 та 502 під час першого запуску - Як IDE допомагає не губитися в усьому цьому
У лекції «Docker і Docker Compose» ми описали середовище у docker-compose.yml. Тепер подивимося, як воно обробляє запит.
Шлях запиту і шляхи до файлів
Тепер з'єднаємо все з модулем 1. Що відбувається, коли ви відкриваєте http://localhost:8080/?
sequenceDiagram participant B as Браузер participant N as web (nginx) participant P as php (PHP-FPM) B->>N: GET / на localhost:8080 N->>N: root = /var/www/html/public, шукає index.php N->>P: FastCGI на php:9000, файл /var/www/html/public/index.php P->>P: виконує PHP-код P-->>N: готовий HTML N-->>B: 200 OK + HTML
Ключова частина конфігурації nginx — файл docker/nginx/default.conf:
server {
listen 80;
root /var/www/html/public; # «корінь» сайту — папка public!
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string; # немає файлу → index.php
}
location ~ \.php$ {
try_files $uri =404; # PHP-файлу немає → 404
fastcgi_pass php:9000; # передати PHP-контейнеру
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
location ~ /\.(?!well-known).* {
deny all; # приховані файли (.env, .git) заборонені
}
}
Таблиця шляхів
Це найважливіша таблиця уроку. Одна й та сама папка має різні адреси «зовні» і «всередині»:
| На вашому комп'ютері | У контейнері web (nginx) |
У контейнері php |
В браузері |
|---|---|---|---|
./src/ |
/var/www/html/ (лише читання) |
/var/www/html/ |
— (недоступна) |
./src/public/ |
/var/www/html/public/ — root |
/var/www/html/public/ |
http://localhost:8080/ |
./src/public/index.php |
/var/www/html/public/index.php |
/var/www/html/public/index.php |
http://localhost:8080/ |
./src/public/about.php |
/var/www/html/public/about.php |
/var/www/html/public/about.php |
http://localhost:8080/about.php |
./docker/nginx/default.conf |
/etc/nginx/conf.d/default.conf |
— | — |
./docker/php/Dockerfile |
— | використовується при збиранні образу | — |
Звідси три правила:
- Сторінки, які відкриваються в браузері, кладемо в
src/public/. Файлsrc/test.php(позаpublic) браузер не побачить — nginx поверне 404. - Папка
src/позаpublic/— місце для коду, який не повинен відкриватися напряму: конфігурації, підключувані файли, дані. Це вже перший крок до безпеки. - Код має бути змонтований за однаковим шляхом в обох контейнерах. nginx передає PHP лише шлях до файлу (
SCRIPT_FILENAME), а PHP-FPM читає файл зі своєї файлової системи. Якщо шляхи різні — отримаєте «File not found».
Увага
Типові помилки першого запуску:
- 404 Not Found — файл лежить не в
src/public/або помилка в назві. - 502 Bad Gateway — nginx не достукався до
php:9000: контейнерphpне запущений або впав (дивітьсяdocker compose logs php). - port is already allocated — порт 8080 зайнятий іншою програмою; змініть ліву частину, наприклад
"8081:80".
IDE: місце, де все сходиться
IDE (Integrated Development Environment) — редактор коду з «розумними» функціями: підсвічування синтаксису, автодоповнення, пошук по проєкту, робота з Git і вбудований термінал.
Для курсу підійде будь-яка з двох:
- Visual Studio Code — безкоштовна. Рекомендовані розширення: PHP Intelephense (підказки PHP), Docker (керування контейнерами), GitLens (історія Git). Українська локалізація — розширення Ukrainian Language Pack.
- PhpStorm — професійна IDE для PHP, для тих, хто навчається, є безкоштовна освітня ліцензія.
Що варто вміти вже сьогодні:
| Дія | VS Code | PhpStorm |
|---|---|---|
| Відкрити проєкт | File → Open Folder | File → Open |
| Вбудований термінал | Ctrl+` |
Alt+F12 |
| Пошук файлу за назвою | Ctrl+P |
Shift двічі |
| Панель Git (зміни, коміт) | Ctrl+Shift+G |
Ctrl+K (коміт) |
Порада
Відкривайте в IDE кореневу папку проєкту (ту, де лежить docker-compose.yml), а не лише src. Тоді вбудований термінал одразу стоїть у правильному місці для команд docker compose, а IDE бачить і код, і конфігурацію.
Перевіримо, що все з'єдналося. Цей мінімальний файл src/public/index.php показує, де насправді виконується код:
<?php
echo '<h1>Привіт із контейнера!</h1>';
echo '<p>Версія PHP: ' . PHP_VERSION . '</p>';
echo '<p>Шлях до файлу: ' . __FILE__ . '</p>'; // /var/www/html/public/index.php
echo '<p>Ім\'я хоста: ' . gethostname() . '</p>'; // ідентифікатор контейнера php
У браузері ви побачите шлях /var/www/html/public/index.php, хоча на вашому диску файл лежить у src/public/index.php. Це і є робота bind mount. Довідка по функціях: php.net/manual/uk.
Щоденний робочий цикл
Відтепер кожне заняття виглядає однаково — запам'ятайте цю послідовність:
- Запустити Docker Desktop (Windows / macOS).
- Відкрити проєкт в IDE і у вбудованому терміналі виконати
git pull, якщо працюєте на кількох комп'ютерах, — забрати зміни, надіслані з іншого. - Запустити середовище:
docker compose up -d. - Писати код у
src/public/, зберігати файл, оновлювати сторінку в браузері (F5). - Якщо щось не так — дивитися
docker compose logs webтаdocker compose logs php. - Наприкінці:
git add,git commit,git push, а потімdocker compose down.
Такий цикл привчає до головного правила командної розробки: робоче середовище однакове в усіх, а вся історія роботи — у Git.
Підсумок
- Папка
./srcпідключена в обидва контейнери як/var/www/htmlчерез bind mount, а root сайту —src/public/. Сторінки для браузера кладемо тільки туди. Іменований том (сховище Docker) знадобиться пізніше — для даних MySQL. - nginx віддає запити на
.phpконтейнеруphpза адресоюphp:9000; PHP виконує файл і повертає HTML. - IDE відкриваємо на корені проєкту і користуємося вбудованим терміналом.
- Щоденний цикл:
docker compose up -d→ код уsrc/public/→F5→ логи → коміт іgit push.
Що далі
Практика «Розгортаємо середовище» — скачуємо стартовий архів, запускаємо контейнери і робимо перші коміти.