К содержимому

docker compose yml: nginx, PHP-FPM и MySQL в одном файле

Файл docker-compose.yml описывает три сервиса: PHP-FPM с расширением pdo_mysql, nginx на порту 80 и MySQL 8.4 с томом для данных. Конфиг рабочий, для своего сервера нужно заменить пароли и проверить права на запись в каталоги storage и bootstrap/cache.

Конфиг Docker 3 мин чтения

Конфиг

docker-compose.yml
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:
Dockerfile
FROM php:8.3-fpm
RUN docker-php-ext-install pdo_mysql
WORKDIR /var/www
docker/nginx.conf
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 внутри контейнера

Как применить и проверить

bash
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 Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.