docker compose yml: nginx, PHP-FPM и MySQL в одном файле
Файл docker-compose.yml описывает три сервиса: PHP-FPM с расширением pdo_mysql, nginx на порту 80 и MySQL 8.4 с томом для данных. Конфиг рабочий, для своего сервера нужно заменить пароли и проверить права на запись в каталоги storage и bootstrap/cache.
Конфиг
services:
app:
build: .
volumes:
- ./:/var/www
depends_on:
- mysql
nginx:
image: nginx:1.27-alpine
ports:
- "80:80"
volumes:
- ./:/var/www
- ./docker/nginx.conf:/etc/nginx/conf.d/default.conf:ro
depends_on:
- app
mysql:
image: mysql:8.4
environment:
MYSQL_DATABASE: app
MYSQL_USER: app
MYSQL_PASSWORD: secret
MYSQL_ROOT_PASSWORD: secret
volumes:
- mysql-data:/var/lib/mysql
volumes:
mysql-data:
FROM php:8.3-fpm
RUN docker-php-ext-install pdo_mysql
WORKDIR /var/www
server {
listen 80;
root /var/www/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass app:9000;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
}
Что заменить под свой сервер
secret- свои пароли, на сервере их держат в .env, а не в файле
DB_HOST- в .env приложения DB_HOST=mysql, это имя сервиса
storage- папки storage и bootstrap/cache должны быть доступны на запись пользователю www-data внутри контейнера
Как применить и проверить
docker compose up -d --build
docker compose ps
docker compose logs -f app
Сервис app: сборка PHP-FPM
Сервис app собирается из локального Dockerfile на базе php:8.3-fpm и ставит расширение pdo_mysql, без него приложение не подключится к MySQL. Каталог проекта монтируется в /var/www, поэтому правки в коде видны в контейнере сразу, без пересборки. Зависимость depends_on: mysql задаёт порядок запуска, но не ждёт готовности базы принимать соединения.
Сервис nginx: порт и конфиг
nginx берётся из образа nginx:1.27-alpine и публикует порт 80 хоста на порт 80 контейнера. Конфиг ./docker/nginx.conf монтируется только для чтения в /etc/nginx/conf.d/default.conf, поэтому после правок достаточно перезапустить контейнер nginx. Корень сайта указывает на /var/www/public, этот путь должен существовать в проекте.
Сервис mysql: база, пользователь и том
Образ mysql:8.4 при первом старте создаёт базу app и пользователя app с паролем из переменных окружения. Данные лежат в именованном томе mysql-data, он переживает пересоздание контейнера. Пароли в файле видны всем, у кого есть доступ к репозиторию, на сервере их выносят в .env.
Что заменить для своего сервера
Замените secret в MYSQL_PASSWORD и MYSQL_ROOT_PASSWORD на свои значения и перенесите их в .env рядом с docker-compose.yml. В приложении укажите DB_HOST=mysql: это имя сервиса, по нему контейнер app находит базу во внутренней сети Compose. Каталоги storage и bootstrap/cache должны быть доступны на запись пользователю www-data внутри контейнера app.
Запуск и проверка
Соберите образы и поднимите контейнеры командой docker compose up -d --build. Команда docker compose ps покажет состояние сервисов: у app, nginx и mysql должно быть running. Если страница отдаёт 502, смотрите docker compose logs -f app: чаще всего PHP-FPM не стартовал из-за ошибки в Dockerfile или приложение не слушает порт 9000.
Проверка конфига nginx и прав
Синтаксис docker/nginx.conf проверяется командой docker compose exec nginx nginx -t, ошибка в директиве не даст nginx запуститься. Директива fastcgi_pass app:9000 отправляет PHP-запросы в контейнер app по имени сервиса, менять её не нужно. Права на запись проверьте командой docker compose exec app ls -ld storage bootstrap/cache: владельцем должен быть www-data.
Где ошибаются, когда правят конфиг
-
В
DB_HOSTуказываютlocalhostили127.0.0.1, и приложение не находит MySQL: внутри контейнера это он сам, а не соседний сервис.Укажите
DB_HOST=mysql, имя сервиса изdocker-compose.yml. Compose разрешает его во внутренней сети. -
Пароли остаются
secretи лежат в репозитории, любой с доступом к файлу получает доступ к базе.Перенесите
MYSQL_PASSWORDиMYSQL_ROOT_PASSWORDв.envрядом сdocker-compose.ymlи добавьте файл в.gitignore. -
После
docker compose up -dсразу идут запросы к базе, MySQL ещё инициализируется, и приложение падает с ошибкой соединения.depends_onне ждёт готовности MySQL. Проверьтеdocker compose logs -f mysqlдо строкиready for connectionsили добавьте healthcheck. -
Каталоги
storageиbootstrap/cacheпринадлежат root, приложение не может писать логи и кеш.Выполните
docker compose exec app chown -R www-data:www-data storage bootstrap/cacheи проверьте права черезls -ld.
Deploykin
Как это делается в Deploykin
В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Зачем в docker-compose.yml отдельный сервис nginx, если PHP-FPM уже есть?
PHP-FPM обрабатывает только PHP и не отдаёт статику и не слушает порт 80. nginx принимает HTTP-запросы, отдаёт файлы из /var/www/public и передаёт PHP-запросы в app на порт 9000.
Как поменять пароль MySQL в этом конфиге?
Замените значения MYSQL_PASSWORD и MYSQL_ROOT_PASSWORD в .env и пересоздайте контейнер командой docker compose up -d. Переменные применяются только при первой инициализации базы, для существующего тома пароль меняют через SQL.
Почему nginx отдаёт 502 Bad Gateway?
nginx не может подключиться к app:9000. Проверьте docker compose ps, что контейнер app запущен, и docker compose logs -f app на ошибки PHP-FPM.
Где хранятся данные MySQL после перезапуска?
В именованном томе mysql-data, он описан в блоке volumes. Том сохраняется при docker compose down, но удаляется командой docker compose down -v.
Ещё по теме
- Руководство · Docker docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы