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

Шлях запиту, шляхи до файлів і 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 — використовується при збиранні образу —

Звідси три правила:

  1. Сторінки, які відкриваються в браузері, кладемо в src/public/. Файл src/test.php (поза public) браузер не побачить — nginx поверне 404.
  2. Папка src/ поза public/ — місце для коду, який не повинен відкриватися напряму: конфігурації, підключувані файли, дані. Це вже перший крок до безпеки.
  3. Код має бути змонтований за однаковим шляхом в обох контейнерах. 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".
Ви створили файл src/hello.php і відкрили http://localhost:8080/hello.php. Що побачите?
Після правки default.conf і docker compose restart web кожна .php-сторінка показує 502 Bad Gateway, хоча docker compose ps каже, що обидва контейнери Up. У конфігу рядок fastcgi_pass php:9001; Де помилка?

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.

Щоденний робочий цикл

Відтепер кожне заняття виглядає однаково — запам'ятайте цю послідовність:

  1. Запустити Docker Desktop (Windows / macOS).
  2. Відкрити проєкт в IDE і у вбудованому терміналі виконати git pull, якщо працюєте на кількох комп'ютерах, — забрати зміни, надіслані з іншого.
  3. Запустити середовище: docker compose up -d.
  4. Писати код у src/public/, зберігати файл, оновлювати сторінку в браузері (F5).
  5. Якщо щось не так — дивитися docker compose logs web та docker compose logs php.
  6. Наприкінці: 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.

Що далі

Практика «Розгортаємо середовище» — скачуємо стартовий архів, запускаємо контейнери і робимо перші коміти.