Docker і Docker Compose
Що ви дізнаєтесь
- Що таке образ, контейнер, bind mount, іменований том і публікація порту
- Як читати Dockerfile і
docker-compose.ymlнашого курсу - Основні команди Docker Compose
Docker: образ, контейнер, томи, порт
Docker запускає програми в ізольованих «коробках» — контейнерах. Контейнер схожий на маленький окремий Linux-комп'ютер: у нього своя файлова система, свої процеси, своя мережа. Але він стартує за секунди, бо використовує ядро вашої системи.
Ключові поняття:
| Поняття | Що це | Аналогія |
|---|---|---|
| Образ (image) | Шаблон: ОС + програми + налаштування. Лише для читання | Інсталяційний диск |
| Контейнер (container) | Запущений екземпляр образу | Встановлена й запущена програма |
| Bind mount (монтування папки) | Папка вашого комп'ютера, «підключена» всередину контейнера: ./src:/var/www/html. Зміни видно з обох боків одразу |
Флешка, вставлена в комп'ютер |
| Іменований том (named volume) | Сховище, яке створює й зберігає сам Docker; переживає видалення контейнера. Знадобиться для даних MySQL | Камера схову: речі лишаються, навіть коли ви пішли |
Публікація порту (ports) |
Відкриває порт контейнера на порту вашого комп'ютера: 8080:80 |
Переадресація дзвінка |
В Compose обидва різновиди записують у розділ volumes: якщо ліворуч шлях (./src) — це bind mount, якщо просто ім'я (db-data:/var/lib/mysql) — іменований том. У нашому файлі поки лише bind mount.
Образ можна взяти готовий (наприклад, nginx:alpine з Docker Hub) або зібрати свій за рецептом — Dockerfile. Наш PHP-образ збирається саме так. Ось скорочена версія файлу docker/php/Dockerfile:
# базовий образ: PHP 8.4 (FPM) на Alpine Linux
FROM php:8.4-fpm-alpine
# системні пакети і розширення PDO для MySQL
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"
# менеджер пакетів PHP
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
# користувач app з вашими UID/GID
ARG UID=1000
ARG GID=1000
RUN addgroup -g ${GID} -S app && adduser -u ${UID} -S app -G app
# робоча папка всередині контейнера
WORKDIR /var/www/html
# PHP працює не від root
USER app
# PHP-FPM слухає порт 9000
EXPOSE 9000
# команда, яка запускається в контейнері
CMD ["php-fpm", "-F"]
З розширень ставимо лише pdo_mysql — через нього PHP працюватиме з базою даних MySQL (модулі 14–15); mbstring для рядків UTF-8 уже вбудований в офіційний образ. Файл php.ini-development вмикає показ помилок у браузері — під час навчання це саме те, що треба.
Примітка
PHP-FPM (FastCGI Process Manager) — це «двигун», який виконує PHP-скрипти на запит вебсервера. Сам по собі він не вміє відповідати браузеру по HTTP — для цього перед ним стоїть nginx.
Зверніть увагу на USER app з ідентифікаторами UID/GID: PHP у контейнері працює від імені звичайного користувача. Якщо його номер збігається з вашим номером користувача на комп'ютері, файли, які створить PHP, ви зможете вільно редагувати.
Docker на Windows і macOS
Контейнери — це технологія ядра Linux. На Windows і macOS встановлюють Docker Desktop, який непомітно запускає маленьку віртуальну машину з Linux, а вже в ній — ваші контейнери. Для вас це означає дві речі:
- перед роботою Docker Desktop має бути запущений (іконка кита в треї), інакше команди
dockerповідомлять, що не можуть під'єднатися до демона; - на Windows Docker Desktop працює через WSL 2. Якщо проєкт лежить усередині WSL (наприклад, у
~/projects), файли читаються помітно швидше, ніж із дискаC:.
На Linux Docker працює напряму, без віртуальної машини, тож потрібно лише встановити Docker Engine і плагін Compose. Інструкції для кожної системи — на docs.docker.com/get-started/get-docker.
Примітка
План Б: якщо Docker недоступний. Коли Docker не вдається встановити чи запустити, тимчасово можна скористатися вбудованим вебсервером PHP (потрібен PHP 8.4 на самому комп'ютері). Виконайте в корені проєкту php -S localhost:8080 -t src/public. Обмеження: немає nginx, тож default.conf із try_files і забороною доступу до .env не діє; docker compose logs/exec не працюють, а помилки видно лише в терміналі з php -S; версія PHP, розширення й налаштування беруться з вашого комп'ютера, а не з Dockerfile. Щойно Docker запрацює, повертайтеся до docker compose up -d.
Docker Compose: наше середовище одним файлом
Можна запускати кожен контейнер окремою довгою командою docker run ..., але зручніше описати всі сервіси в одному файлі docker-compose.yml і керувати ними разом. Це і є Docker Compose.
Ось файл нашого курсу:
services:
web: # сервіс №1 — вебсервер nginx
image: nginx:alpine # готовий образ з Docker Hub
container_name: intita
restart: unless-stopped
ports:
- "8080:80" # порт 8080 комп'ютера → порт 80 контейнера
volumes:
- ./src:/var/www/html:ro # код проєкту (лише читання)
- ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro # конфіг nginx
depends_on:
- php # спочатку стартує php
networks:
- intita
php: # сервіс №2 — PHP-FPM
build:
context: ./docker/php # тут лежить Dockerfile
args:
UID: "${UID:-1000}" # 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 # спільна внутрішня мережа для двох контейнерів
Порада
Цей файл разом із конфігом nginx, Dockerfile, .gitignore і стартовою сторінкою src/public/index.php зібрано в архів intita-php.zip. На практиці ви його скачаєте й розпакуєте, тож набирати конфігурацію вручну не доведеться.
Що тут важливо:
ports: "8080:80"— публікація порту: ліворуч порт вашого комп'ютера, праворуч — контейнера. Тому сайт відкривається за адресоюhttp://localhost:8080.volumes— обидва записи тут є bind mount: ліворуч шлях на комп'ютері (відносно папки зdocker-compose.yml), праворуч — шлях у контейнері. Ви редагуєте файл у./src, і контейнер одразу бачить зміну — перезапускати нічого не треба. Іменованого тому в нашому файлі поки немає — він з'явиться, коли додамо базу даних MySQL.:ro(read-only) — nginx може лише читати код. Писати файли (наприклад, завантаження) буде тільки PHP.networks: intita— обидва контейнери в одній мережі і знаходять один одного за ім'ям сервісу: для nginx адреса PHP — це простоphp.buildпротиimage— дляwebбереться готовий образ, а дляphpCompose спершу збирає власний образ за Dockerfile з папки./docker/phpі зберігає його під ім'ям, указаним вimage.depends_on— порядок запуску: спочаткуphp, потімweb. Зауважте: це гарантує лише порядок старту, а не те, що PHP вже повністю готовий приймати запити.restart: unless-stopped— якщо контейнер впаде або комп'ютер перезавантажиться, Docker підніме його знову, поки ви самі не зупините його командоюdocker compose downчиstop.container_name— фіксоване ім'я контейнера (intita,intita_php), яке видно вdocker psі в Docker Desktop. Без нього Docker згенерував би ім'я з назви папки проєкту.
Змінні UID і GID
У розділі build.args стоїть запис "${UID:-1000}". Це означає: «взяти значення змінної оточення UID, а якщо її немає — підставити 1000». Значення передається в Dockerfile і стає номером користувача app усередині контейнера.
На Windows і macOS це ні на що не впливає. На Linux варто, щоб номер збігався з вашим (перевірте командою id -u). Якщо у вас не 1000, створіть поруч із docker-compose.yml файл .env — Compose прочитає його автоматично:
echo "UID=$(id -u)" > .env
echo "GID=$(id -g)" >> .env
docker compose up -d --build
Інакше файли, які створить PHP (наприклад, збережені дані в модулі 13 «Файли та JSON»), належатимуть «чужому» користувачу, і IDE не зможе їх змінити.
Основні команди Compose
Усі команди виконуються в папці, де лежить docker-compose.yml:
docker compose up -d --build # зібрати образи (якщо треба) і запустити у фоні
docker compose ps # стан контейнерів
docker compose logs web # логи nginx (помилки 404, 502 тощо)
docker compose logs -f php # логи PHP у реальному часі (Ctrl+C — вийти)
docker compose exec php php -v # виконати команду всередині контейнера php
docker compose restart web # перезапустити nginx (після зміни default.conf)
docker compose down # зупинити і видалити контейнери (файли в src лишаються)
Приблизний вивід docker compose ps, коли все гаразд:
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
intita nginx:alpine "/docker-entrypoint.…" web 2 minutes ago Up 2 minutes 0.0.0.0:8080->80/tcp
intita_php intita/php:8.4-fpm "docker-php-entrypoi…" php 2 minutes ago Up 2 minutes 9000/tcp
Важливо
Перший запуск docker compose up -d --build триває кілька хвилин і потребує інтернету: Docker завантажує базові образи і встановлює розширення PHP. Наступні запуски — секунди.
Детальніше: docs.docker.com/compose.
Підсумок
- Docker запускає програми в контейнерах, створених з образів; Dockerfile — рецепт образу.
- Docker Compose описує все середовище одним файлом: у нас сервіси
web(nginx, опублікований порт8080) іphp(PHP-FPM 8.4, порт9000усередині мережі). - Головні команди:
docker compose up -d --build,docker compose ps,docker compose logs,docker compose down.
Що далі
Наступна лекція — «Шлях запиту, шляхи до файлів і IDE»: як запит проходить крізь контейнери і де лежать файли.