Перейти до змісту
Intita
Практика · 80 хв · Макс. бал: 10

Практика: розгортаємо середовище 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. Інструменти і стартовий архів

  1. Перевірте інструменти. Відкрийте термінал (на Windows / macOS спершу запустіть Docker Desktop) і виконайте:

    git --version
    docker --version
    docker compose version
    

    Кожна команда має вивести номер версії. Якщо docker пише, що не може під'єднатися до демона, — Docker Desktop не запущений.

  2. Налаштуйте Git (якщо ще не робили на цьому комп'ютері):

    git config --global user.name "Ваше Ім'я"
    git config --global user.email "you@example.com"
    
  3. Скачайте стартовий архів intita-php.zip і розпакуйте його в папку, де зберігатимете навчальні проєкти. Має з'явитися папка intita-php з файлами, як у дереві вище.

    Увага

    Провідник Windows («Видобути все») часто створює зайву вкладену папку intita-php\intita-php. Робоча папка — та, де безпосередньо лежить docker-compose.yml. Файл .gitignore починається з крапки, тому провідник Windows і Finder на macOS можуть його не показувати. В IDE його видно.

  4. Відкрийте папку intita-php в IDE (саме її, а не src). Команди далі виконуйте у вбудованому терміналі IDE.

  5. Створіть репозиторій — у терміналі в папці intita-php:

    git init
    

    В архіві немає папки .git, тож історію проєкту починаєте ви. Поки нічого не комітьте: перший коміт буде після запуску (крок 14).

Частина 2. Файли середовища

Набирати нічого не треба: усі файли вже є в архіві. Відкрийте кожен в IDE і прочитайте пояснення. Відповіді на запитання в Частині 5 спираються саме на ці рядки.

  1. Розгляньте 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: bridge
    
    • web бере готовий образ 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 поверне помилку розбору файлу.

  2. Розгляньте 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.
  3. Розгляньте 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 надсилає запити.
  4. Розгляньте .gitignore — у ньому перелічено файли й папки, які Git має пропускати:

    # локальні налаштування (UID/GID на Linux)
    .env
    # службові папки IDE
    .idea/
    .vscode/
    # залежності Composer
    vendor/
    

    Тому git status не показуватиме ці файли, і навіть git add . не додасть їх до коміту. Ім'я файлу починається з крапки і не має розширення.

  5. Розгляньте стартову сторінку src/public/index.php:

    <?php
    echo 'Середовище працює!';
    
  6. (Лише Linux.) Перевірте id -u. Якщо результат не 1000, створіть у корені проєкту файл .env:

    echo "UID=$(id -u)" > .env
    echo "GID=$(id -g)" >> .env
    

    .env уже є в .gitignore, тож у коміт він не потрапить.

Частина 3. Запуск

  1. Запустіть середовище. Перший запуск триває кілька хвилин — Docker завантажує nginx і збирає образ PHP:

    docker compose up -d --build
    docker compose ps
    

    В колонці STATUS обидва контейнери — intita і intita_php — мають бути Up.

  2. Відкрийте сайт за адресою 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.
  1. Зробіть перший коміт — зафіксуйте робоче середовище:

    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-сторінки

  1. Замініть вміст 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>
    
  2. Зробіть коміт:

    git add src/public/index.php
    git commit -m "practice: home page with environment info"
    
  3. Створіть сторінку src/public/about.php з заголовком <h1>, 2–3 реченнями про себе і посиланням назад на головну (<a href="/">). Перевірте її за адресою http://localhost:8080/about.php.

Частина 5. Експеримент зі шляхами

  1. Файл поза public. Створіть файл src/test.php (саме в src, не в public) з одним рядком <?php echo 'test';. Відкрийте http://localhost:8080/test.php і запишіть, що побачили. Потім подивіться логи nginx:

    docker compose logs web
    

    Після експерименту видаліть src/test.php.

  2. Загляньте всередину контейнера php:

    docker compose exec php php -v
    docker compose exec php ls -la /var/www/html/public
    

    Порівняйте список файлів із тим, що бачите в IDE у папці src/public.

  3. Створіть у корені проєкту файл NOTES.md і коротко (1–2 речення на кожне) дайте відповіді:

    • Чому src/test.php не відкрився в браузері, а src/public/about.php — відкрився? (Підказка: подивіться на root у default.conf.)
    • Який шлях показала головна сторінка в рядку «Шлях до файлу» і чому він відрізняється від шляху на вашому диску?
    • Навіщо в docker-compose.yml у сервісу web стоїть :ro після шляху до ./src?

Частина 6. Зламай і полагодь

Тут ви навмисно ламаєте середовище і лагодите його. Усі зміни безпечні й зворотні: образ перезбирати не доведеться.

  1. 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
    

    Оновіть сторінку — головна знову на місці.

  2. Дві частини ports. Запис "8080:80" у docker-compose.yml має дві частини. Перевірте, що відповідає за кожну:

    1. Змініть "8080:80" на "8081:80" і виконайте docker compose up -d. Сайт відкривається на http://localhost:8081, а на старій адресі з'єднання немає:

      curl -I http://localhost:8080
      
      curl: (7) Failed to connect to localhost port 8080 …
      

      У Windows PowerShell пишіть curl.exe.

    2. Змініть запис на "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:8080
      

      HTTP-відповіді не буде, лише помилка з'єднання. Її текст залежить від ОС і версії Docker, наприклад:

      curl: (56) Recv failure: Connection reset by peer
      curl: (52) Empty reply from server
      

      Порт 8080 на комп'ютері відкритий, але Docker передає запит на порт 8080 контейнера, а nginx усередині слухає 80 (listen 80 у default.conf).

    3. Поверніть "8080:80", виконайте docker compose up -d і перевірте, що http://localhost:8080 знову працює.

    4. Запишіть у NOTES.md, яка частина запису — порт вашого комп'ютера, а яка — порт контейнера, і що зламалося в кожному з двох випадків.

Частина 7. Здача роботи

  1. Зробіть коміт:

    git add src/public/about.php NOTES.md
    git commit -m "practice: about page and answers about paths"
    git log --oneline
    
  2. Увійдіть у GitHub (один раз на комп'ютері). Пароль від акаунта GitHub для git push не підходить. Способи входу описано в лекції, у розділі «Вхід у GitHub». Виберіть один:

    • Windows — нічого не робіть заздалегідь: під час першого git push Git 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.

  3. Відправте роботу на 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) і спробуйте знову.

  4. Зупиніть середовище наприкінці заняття:

    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 — за правилами, оголошеними на занятті.

Додатково (*)

  1. Створіть src/public/info.php з рядком <?php phpinfo();, знайдіть на сторінці розділи pdo_mysql і mbstring та значення date.timezone і display_errors і порівняйте їх з docker/php/Dockerfile. Після перевірки видаліть файл — phpinfo() на реальному сервері розкриває зловмисникам конфігурацію.

  2. Зберіть середовище з нуля. Зупиніть основне середовище (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.