Практика: розгортаємо середовище PHP-розробника
Мета
Розгорнути зі стартового архіву робоче середовище, в якому працюватимемо весь курс: Git, Docker Compose (nginx + PHP 8.4) та IDE. Зрозуміти, з яких файлів складається середовище, навчитися розрізняти шляхи на комп'ютері й у контейнерах і зберігати роботу комітами.
Завдання
Скачайте стартовий архів intita-php.zip, розпакуйте його і розберіться, що роблять три конфігураційні файли (docker-compose.yml, конфіг nginx, Dockerfile для PHP). Потім запустіть контейнери, створіть у src/public/ дві PHP-сторінки, проведіть експеримент зі шляхами і зробіть щонайменше два коміти з осмисленими повідомленнями, відправивши роботу у свій репозиторій на GitHub.
Структура проєкту після розпакування архіву:
intita-php/
├── .gitignore # що НЕ зберігати в Git
├── docker-compose.yml # опис сервісів web і php
├── docker/
│ ├── nginx/
│ │ └── default.conf # конфіг nginx (root = /var/www/html/public)
│ └── php/
│ └── Dockerfile # рецепт образу PHP 8.4-FPM
└── src/ # → /var/www/html у контейнерах
└── public/ # → корінь сайту, http://localhost:8080/
└── index.php
Важливо
Не перейменовуйте й не переміщуйте файли з архіву. Шляхи в docker-compose.yml відносні до папки, де він лежить, і мають збігатися з деревом вище до літери: docker/nginx/default.conf, docker/php/Dockerfile (без розширення!), src/public/. Інакше nginx не знайде конфіг, Compose не знайде Dockerfile, а браузер отримає 404.
Кроки
Частина 1. Інструменти і стартовий архів
-
Перевірте інструменти. Відкрийте термінал (на Windows / macOS спершу запустіть Docker Desktop) і виконайте:
git --version docker --version docker compose versionКожна команда має вивести номер версії. Якщо
dockerпише, що не може під'єднатися до демона, — Docker Desktop не запущений. -
Налаштуйте Git (якщо ще не робили на цьому комп'ютері):
git config --global user.name "Ваше Ім'я" git config --global user.email "you@example.com" -
Скачайте стартовий архів intita-php.zip і розпакуйте його в папку, де зберігатимете навчальні проєкти. Має з'явитися папка
intita-phpз файлами, як у дереві вище.Увага
Провідник Windows («Видобути все») часто створює зайву вкладену папку
intita-php\intita-php. Робоча папка — та, де безпосередньо лежитьdocker-compose.yml. Файл.gitignoreпочинається з крапки, тому провідник Windows і Finder на macOS можуть його не показувати. В IDE його видно. -
Відкрийте папку
intita-phpв IDE (саме її, а неsrc). Команди далі виконуйте у вбудованому терміналі IDE. -
Створіть репозиторій — у терміналі в папці
intita-php:git initВ архіві немає папки
.git, тож історію проєкту починаєте ви. Поки нічого не комітьте: перший коміт буде після запуску (крок 14).
Частина 2. Файли середовища
Набирати нічого не треба: усі файли вже є в архіві. Відкрийте кожен в IDE і прочитайте пояснення. Відповіді на запитання в Частині 5 спираються саме на ці рядки.
-
Розгляньте
docker-compose.yml(у корені проєкту). Він описує два сервіси:web(nginx) іphp(PHP-FPM), які спілкуються через спільну мережуintita:services: web: image: nginx:alpine container_name: intita restart: unless-stopped ports: - "8080:80" volumes: - ./src:/var/www/html:ro - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro depends_on: - php networks: - intita php: build: context: ./docker/php args: UID: "${UID:-1000}" GID: "${GID:-1000}" image: intita/php:8.4-fpm container_name: intita_php restart: unless-stopped working_dir: /var/www/html volumes: - ./src:/var/www/html networks: - intita networks: intita: driver: bridgewebбере готовий образnginx:alpine, аphpзбирається з Dockerfile (build.context: ./docker/php), і зібраний образ зберігається під ім'ям зimage.ports: "8080:80": ліворуч порт вашого комп'ютера, праворуч порт контейнера. Тому сайт відкривається наhttp://localhost:8080.volumes: папка./srcз'являється в обох контейнерах як/var/www/html, для nginx лише на читання (:ro). Другий запис підкладає nginx нашdefault.conf.networks: intita: контейнери бачать один одного за ім'ям сервісу (php,web).container_nameзадає іменаintitaтаintita_php, які ви побачите вdocker compose ps.UID/GIDуbuild.args— див. крок 11.
Увага
Якщо правитимете цей файл (наприклад, у «Додатково (*)»), пам'ятайте, що в YAML важливі відступи: лише пробіли, по 2 на рівень, без табуляцій. Зсунутий на один пробіл рядок — і
docker composeповерне помилку розбору файлу. -
Розгляньте
docker/nginx/default.conf— конфіг вебсервера. Він каже nginx шукати файли в/var/www/html/public, а запити до.php-файлів передавати контейнеруphpна порт9000:server { listen 80; server_name _; root /var/www/html/public; index index.php index.html; client_max_body_size 32M; add_header X-Frame-Options "SAMEORIGIN"; add_header X-Content-Type-Options "nosniff"; location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { try_files $uri =404; fastcgi_split_path_info ^(.+\.php)(/.+)$; fastcgi_pass php:9000; fastcgi_index index.php; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_read_timeout 300; } location ~ /\.(?!well-known).* { deny all; } error_log /var/log/nginx/error.log; access_log /var/log/nginx/access.log; }root— корінь сайту: браузер «бачить» лише вмістsrc/public/.location /зtry_files— спершу nginx шукає файл, потім папку, а якщо нічого немає — передає запитindex.php.fastcgi_pass php:9000—phpтут — ім'я сервісу зdocker-compose.yml, Docker сам перетворює його на адресу контейнера.- Останній
locationзабороняє доступ до прихованих файлів на кшталт.envчи.git.
-
Розгляньте
docker/php/Dockerfile— рецепт образу PHP 8.4-FPM з розширенням для роботи з MySQL (знадобиться в модулях 14–15), налаштуваннями PHP для розробки та Composer:FROM php:8.4-fpm-alpine RUN apk add --no-cache \ git \ unzip \ bash \ && docker-php-ext-install pdo_mysql RUN cp "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini" \ && echo "date.timezone=Europe/Kyiv" > "$PHP_INI_DIR/conf.d/timezone.ini" COPY --from=composer:latest /usr/bin/composer /usr/bin/composer ARG UID=1000 ARG GID=1000 RUN addgroup -g ${GID} -S app \ && adduser -u ${UID} -S app -G app \ && mkdir -p /var/www/html \ && chown -R app:app /var/www/html /var/log WORKDIR /var/www/html USER app EXPOSE 9000 CMD ["php-fpm", "-F"]FROM— базовий офіційний образ PHP 8.4-FPM на Alpine Linux. Розширенняmbstring(робота з рядками UTF-8) у ньому вже є.RUN apk add …— системні програми:gitіunzipпотрібні Composer,bash— зручна оболонка в контейнері.docker-php-ext-install pdo_mysql— розширення PDO для MySQL: через нього PHP підключатиметься до бази даних у модулях 14–15.php.ini-development→php.ini— налаштування PHP для розробки: помилки показуються просто в браузері (display_errors). На справжньому сервері берутьphp.ini-production, де помилки приховано від відвідувачів.date.timezone=Europe/Kyiv— часовий пояс за замовчуванням:date()показуватиме київський час, а не UTC.COPY --from=composer…— Composer, менеджер пакетів PHP.ARG UID/GIDіaddgroup/adduserстворюють у контейнері користувачаappз вашими номерамиUID/GID.USER app— PHP-FPM працює від іменіapp, а неroot, тож файли, які створює PHP, належать вам, і IDE може їх змінювати.EXPOSE 9000іCMD ["php-fpm", "-F"]— PHP-FPM слухає порт 9000, куди nginx надсилає запити.
-
Розгляньте
.gitignore— у ньому перелічено файли й папки, які Git має пропускати:# локальні налаштування (UID/GID на Linux) .env # службові папки IDE .idea/ .vscode/ # залежності Composer vendor/Тому
git statusне показуватиме ці файли, і навітьgit add .не додасть їх до коміту. Ім'я файлу починається з крапки і не має розширення. -
Розгляньте стартову сторінку
src/public/index.php:<?php echo 'Середовище працює!'; -
(Лише Linux.) Перевірте
id -u. Якщо результат не1000, створіть у корені проєкту файл.env:echo "UID=$(id -u)" > .env echo "GID=$(id -g)" >> .env.envуже є в.gitignore, тож у коміт він не потрапить.
Частина 3. Запуск
-
Запустіть середовище. Перший запуск триває кілька хвилин — Docker завантажує nginx і збирає образ PHP:
docker compose up -d --build docker compose psВ колонці
STATUSобидва контейнери —intitaіintita_php— мають бутиUp. -
Відкрийте сайт за адресою http://localhost:8080. Має з'явитися напис «Середовище працює!».
Примітка
План Б: якщо Docker недоступний. Буває, що Docker не вдається встановити чи запустити: немає прав адміністратора, вимкнена віртуалізація, слабкий комп'ютер. Тоді тимчасово скористайтеся вбудованим вебсервером PHP. Для цього PHP 8.4 має бути встановлений на самому комп'ютері (перевірка: php -v). У папці intita-php виконайте:
php -S localhost:8080 -t src/public
Сторінки відкриються за тією самою адресою http://localhost:8080, а зупинити сервер можна клавішами Ctrl+C. Обмеження:
- немає nginx, тож
default.confне діє: ніtry_files, ні заборона доступу до прихованих файлів на кшталт.env, ні заголовки безпеки; docker compose ps,docker compose logsіdocker compose execне працюють. Запити й помилки видно лише у вікні терміналу, де запущеноphp -S;- версія PHP, розширення (
pdo_mysql) і налаштування (display_errors,date.timezone) беруться з вашого комп'ютера, а не з Dockerfile; __FILE__іgethostname()покажуть шлях на вашому диску та ім'я комп'ютера, тому експеримент зі шляхами в Частині 5 не вийде;- це сервер лише для розробки. Щойно Docker запрацює, поверніться до
docker compose up -d --build.
-
Зробіть перший коміт — зафіксуйте робоче середовище:
git status git add .gitignore docker-compose.yml docker src git commit -m "practice: nginx and PHP 8.4 in Docker Compose"У виводі
git statusне має бути.env,.idea/чи.vscode/. Якщо вони там є, перевірте ім'я та вміст.gitignore.
Частина 4. Перші PHP-сторінки
-
Замініть вміст
src/public/index.phpна код нижче, вписавши своє ім'я. Збережіть файл і оновіть сторінку (F5) — контейнери перезапускати не треба:<?php $name = 'Олена Петренко'; ?> <!DOCTYPE html> <html lang="uk"> <head> <meta charset="UTF-8"> <title>Моє середовище</title> </head> <body> <h1>Привіт! Мене звати <?= $name ?></h1> <p>Версія PHP: <?= PHP_VERSION ?></p> <p>Шлях до файлу в контейнері: <?= __FILE__ ?></p> <p>Ім'я хоста (контейнер php): <?= gethostname() ?></p> <p>Час на сервері (Київ): <?= date('H:i:s') ?></p> <p><a href="/about.php">Про мене</a></p> </body> </html> -
Зробіть коміт:
git add src/public/index.php git commit -m "practice: home page with environment info" -
Створіть сторінку
src/public/about.phpз заголовком<h1>, 2–3 реченнями про себе і посиланням назад на головну (<a href="/">). Перевірте її за адресоюhttp://localhost:8080/about.php.
Частина 5. Експеримент зі шляхами
-
Файл поза
public. Створіть файлsrc/test.php(саме вsrc, не вpublic) з одним рядком<?php echo 'test';. Відкрийтеhttp://localhost:8080/test.phpі запишіть, що побачили. Потім подивіться логи nginx:docker compose logs webПісля експерименту видаліть
src/test.php. -
Загляньте всередину контейнера php:
docker compose exec php php -v docker compose exec php ls -la /var/www/html/publicПорівняйте список файлів із тим, що бачите в IDE у папці
src/public. -
Створіть у корені проєкту файл
NOTES.mdі коротко (1–2 речення на кожне) дайте відповіді:- Чому
src/test.phpне відкрився в браузері, аsrc/public/about.php— відкрився? (Підказка: подивіться наrootуdefault.conf.) - Який шлях показала головна сторінка в рядку «Шлях до файлу» і чому він відрізняється від шляху на вашому диску?
- Навіщо в
docker-compose.ymlу сервісуwebстоїть:roпісля шляху до./src?
- Чому
Частина 6. Зламай і полагодь
Тут ви навмисно ламаєте середовище і лагодите його. Усі зміни безпечні й зворотні: образ перезбирати не доведеться.
-
502 Bad Gateway. Зупиніть лише контейнер PHP:
docker compose stop php docker compose psКонтейнер
intitaпрацює, аintita_phpу списку вже немає. Спершу прогноз: до оновлення сторінки запишіть уNOTES.md, що покаже браузер наhttp://localhost:8080. Тепер оновіть сторінку. Має з'явитися сторінка nginx «502 Bad Gateway». Подивіться логи nginx:docker compose logs webЗнайдіть рядок з
[error]. Він виглядає приблизно так (час, номер помилки й IP-адреса у вас можуть бути інші):intita | 2026/09/27 22:44:24 [error] 22#22: *3 connect() failed (113: Host is unreachable) while connecting to upstream, client: 172.18.0.1, server: _, request: "GET / HTTP/1.1", upstream: "fastcgi://172.18.0.2:9000", host: "localhost:8080"Поясніть у
NOTES.md(1–2 речення): хто саме відповів браузеру кодом 502 і чому. Підказка: подивіться наupstreamі наfastcgi_passуdefault.conf. Потім полагодьте:docker compose start phpОновіть сторінку — головна знову на місці.
-
Дві частини
ports. Запис"8080:80"уdocker-compose.ymlмає дві частини. Перевірте, що відповідає за кожну:-
Змініть
"8080:80"на"8081:80"і виконайтеdocker compose up -d. Сайт відкривається наhttp://localhost:8081, а на старій адресі з'єднання немає:curl -I http://localhost:8080curl: (7) Failed to connect to localhost port 8080 …У Windows PowerShell пишіть
curl.exe. -
Змініть запис на
"8080:8080". Спершу прогноз: запишіть уNOTES.md, що тепер покажеhttp://localhost:8080. Потім виконайтеdocker compose up -dіdocker compose ps: у колонціPORTSу контейнераintitaє0.0.0.0:8080->8080/tcp. Перевірте:curl -I http://localhost:8080HTTP-відповіді не буде, лише помилка з'єднання. Її текст залежить від ОС і версії Docker, наприклад:
curl: (56) Recv failure: Connection reset by peer curl: (52) Empty reply from serverПорт 8080 на комп'ютері відкритий, але Docker передає запит на порт 8080 контейнера, а nginx усередині слухає 80 (
listen 80уdefault.conf). -
Поверніть
"8080:80", виконайтеdocker compose up -dі перевірте, щоhttp://localhost:8080знову працює. -
Запишіть у
NOTES.md, яка частина запису — порт вашого комп'ютера, а яка — порт контейнера, і що зламалося в кожному з двох випадків.
-
Частина 7. Здача роботи
-
Зробіть коміт:
git add src/public/about.php NOTES.md git commit -m "practice: about page and answers about paths" git log --oneline -
Увійдіть у GitHub (один раз на комп'ютері). Пароль від акаунта GitHub для
git pushне підходить. Способи входу описано в лекції, у розділі «Вхід у GitHub». Виберіть один:-
Windows — нічого не робіть заздалегідь: під час першого
git pushGit Credential Manager відкриє вікно входу, натисніть Sign in with your browser. Перевірка:git config --get credential.helperмає вивестиmanager. -
GitHub CLI (будь-яка ОС) — виконайте
gh auth loginі перевірте вхід:gh auth statusУ виводі має бути рядок
Logged in to github.com account <ваш-логін>. -
IDE — увійдіть у GitHub у VS Code (Accounts → Sign in with GitHub) або PhpStorm (Settings → Version Control → GitHub) і надсилайте коміти кнопкою Push.
-
Токен — якщо жоден спосіб не підходить, створіть fine-grained токен лише для репозиторію
intita-phpі вставте його, коли Git запитаєPassword.
-
-
Відправте роботу на GitHub. Створіть на GitHub порожній репозиторій
intita-php(без README і.gitignore), скопіюйте його адресу і виконайте:git branch -M main git remote add origin https://github.com/<ваш-логін>/intita-php.git git push -u origin mainУвага
Повідомлення
remote: Support for password authentication was removed on August 13, 2021.іfatal: Authentication failed for 'https://github.com/…'означають, що ви ввели пароль від GitHub. Git його більше не приймає. Поверніться до кроку 24, увійдіть через браузер,gh auth loginчи IDE або вставте токен замість пароля, і повторітьgit push. Якщо Windows запам'ятала неправильні дані, видаліть записgit:https://github.comу Диспетчері облікових даних (Credential Manager) і спробуйте знову. -
Зупиніть середовище наприкінці заняття:
docker compose down
Порада
Якщо щось не працює — спершу docker compose ps, потім docker compose logs web і docker compose logs php. 404 — файл не в src/public/; 502 Bad Gateway — не працює контейнер php; port is already allocated — порт 8080 зайнятий, змініть "8080:80" на "8081:80"; Authentication failed під час git push — GitHub не приймає пароль, увійдіть через браузер, gh auth login чи IDE (крок 24).
Очікуваний результат
Головна сторінка має виглядати приблизно так (версія PHP, ім'я хоста й час у вас будуть інші):
Після Частини 6 у NOTES.md є пояснення 502 (хто відповів і чому) і того, яку частину ports ви змінювали, а сайт знову відкривається на http://localhost:8080.
Критерії оцінювання
Роботу оцінюють за 10-бальною шкалою:
| Критерій | Бали |
|---|---|
Середовище запускається: http://localhost:8080 показує головну сторінку з вашим ім'ям (крок 15), як в «Очікуваному результаті» |
2 |
Сторінка about.php із заголовком, текстом і посиланням на головну (крок 17) |
2 |
NOTES.md: відповіді на три питання кроку 20 |
2 |
Частина 6: у NOTES.md прогнози, пояснення 502 за логами nginx і різниці лівої та правої частини ports; середовище відновлено |
2 |
Репозиторій на GitHub: коміти кроків 14, 16 і 23 з осмисленими повідомленнями, без файлів, які виключає .gitignore |
2 |
| Разом | 10 |
Завдання з розділу «Додатково (*)» балів понад 10 не додає: воно може повернути до 2 балів, знятих за критеріями вище, але оцінка не перевищує 10.
Що здати
Посилання на ваш репозиторій (або архів папки intita-php без папки .git, якщо так домовилися на занятті) і скриншот сторінки http://localhost:8080 — за правилами, оголошеними на занятті.
Додатково (*)
-
Створіть
src/public/info.phpз рядком<?php phpinfo();, знайдіть на сторінці розділиpdo_mysqlіmbstringта значенняdate.timezoneіdisplay_errorsі порівняйте їх зdocker/php/Dockerfile. Після перевірки видаліть файл —phpinfo()на реальному сервері розкриває зловмисникам конфігурацію. -
Зберіть середовище з нуля. Зупиніть основне середовище (
docker compose down), бо імена контейнерів і порт 8080 збігаються. Створіть поруч нову порожню папкуintita-php-manualі власноруч наберіть у ній ті самі файли за деревом із розділу «Завдання» та блоками з Частини 2:docker-compose.yml,docker/nginx/default.conf,docker/php/Dockerfile,src/public/index.php. Запустітьdocker compose up -d --buildі перевірте http://localhost:8080. Потім порівняйте свої файли з архівними, наприкладgit diff --no-index ../intita-php/docker docker, і поясніть уNOTES.mdзнайдені розбіжності. Наприкінці виконайтеdocker compose downу цій папці.Увага
Файл називається рівно
Dockerfile— з великої літери і без розширення. Блокнот Windows любить непомітно дописати.txt; перевірте ім'я в IDE. У YAML — лише пробіли, по 2 на рівень.
Довідка: docs.docker.com/compose, git-scm.com/book/uk, php.net/manual/uk.