Я использую для локальной разработки docker compose.
В его конфигурационном файле собираю все нужные контейнеры (PHP, MySQL, Rabbit, Mongo и т.д.) в сеть. Для PHP делаю два контейнера из разных образов:
Один из образа php-fpm, это сам сервер.
Второй из образа php-cli, он используется как раз для всех консольных команд. Именню в него устанавливаю Composer.
Для того, чтобы не писать для запуска консольных команд постоянно это заклинание "docker compose run ...", я делаю Makefile, в котором прописываю часто-используемые команды.
И, набрав
"make cc" на самом деле запускаю
"docker-compose run --rm php-cli bin/console c:c"
Чтобы это всё работало без необходимости постоянно перезапускать docker-compose, я файлы проекта пробрасываю внутрь контейнеров не копированием, а через вольюм, и когда я буду их менять, они будут меняться и внутри контейнера. Так же подключаю прямо внутрь контейнера .env файл, чтобы все переменные окружения туда пробросились.
Я вам прямо закину кучу файлов из одного из своих старых проектов, может накопаете там идей каких-то для себя:
1. docker-compose.yml
version: '3.8'
services:
# Поднимаю сразу реверс-прокси, чтобы пробросить всё наружу на нужный мне порт.m
nginx:
build:
context: ./.docker/nginx
dockerfile: Dockerfile.dev
volumes:
- ./:/app
depends_on:
- php-fpm
ports:
- "8080:80"
php-fpm:
build:
context: ./.docker/php
dockerfile: Dockerfile.fpm-dev
args:
IMAGE_ENV: dev
volumes:
# Вот тут вся магия) Мы просто подключаем файлы проекта в виде вольюма
# Т.е. имеем доступ ко всем файлам и изнутри и снаружи контейнера.
# Внутри контейнера файлы будут видны по пути /app
- ./:/app
environment:
# Даже XDEBUG можно пробросить для IDE
XDEBUG_CONFIG: 'discover_client_host=true client_host=127.0.0.1 log_level=0 client_port=9003'
PHP_IDE_CONFIG: "serverName=Docker"
env_file:
- .env.local
depends_on:
- mysql
# Делаю отдельный контейнер для комманд-лайн утилит,
# чтобы не проще запускать консоль Symfony. Мне так удобнее.
# Здесь будет всё практически как и у php-fpm, только без самого php-fpm процесса
php-cli:
build:
context: ./.docker/php
dockerfile: Dockerfile.cli-dev
args:
IMAGE_ENV: dev
volumes:
- ./:/app
- composer:/root/.composer/cache
environment:
XDEBUG_CONFIG: 'discover_client_host=true client_host=127.0.0.1 log_level=0 client_port=9003'
PHP_IDE_CONFIG: "serverName=Docker"
env_file:
- .env.local
depends_on:
- mysql
mysql:
build:
context: ./.docker/db
dockerfile: Dockerfile
volumes:
- mysql:/var/lib/mysql
env_file:
- .env.local
environment:
MYSQL_ROOT_HOST: '%' # needs to be enclosed with quotes
ports:
- "6603:3306"
# Тут ещё два дополнительных вольюма. Один для кэша composer, а второй для файлов базы данных, чтобы она не убивалась при перезапуске наших контейнеров. Убивать мы её будем только сознательно. если нам надо её очистить.
volumes:
composer:
mysql:
2. Все три докерфайла
Файлы с конфигурациями, которые будут копироваться внутри докерфайлов, кидать не буду, у вас всё своё будет в любом случае.
Dockerfile.dev - для nginx.
# Образ Nginx
FROM nginx:alpine
# Копируем файл с настройками
COPY ./task/default.conf /etc/nginx/conf.d/default.conf
# Устанавливаем рабочую директорию
WORKDIR /app
Dockerfile.fpm-dev - для сервера php-fpm
# Образ php-fpm
FROM php:8.2-fpm
ARG IMAGE_ENV
# Устанавливаем нужные пакеты и расширения
RUN apt-get update && apt-get install -y -qq libpq-dev unzip libxml2-dev libicu-dev libonig-dev zlib1g-dev libpng-dev librabbitmq-dev \
&& docker-php-ext-configure pdo_mysql --with-pdo-mysql=mysqlnd && docker-php-ext-install pdo_mysql && \
docker-php-ext-configure intl && docker-php-ext-install intl && \
pecl install xdebug amqp && rm -rf /tmp/pear && docker-php-ext-enable xdebug amqp && \
rm -rf /var/lib/apt/lists/*
# Use the default development configuration
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
# Копируем файл с настройками xdebug
COPY ./php.d/${IMAGE_ENV}/default.ini /usr/local/etc/php/conf.d/default.ini
COPY ./php.d/${IMAGE_ENV}/xdebug.ini /usr/local/etc/php/conf.d/xdebug.ini
# Создаем пользователя app, чтобы не работать под рутом
RUN adduser --disabled-password --gecos '' --uid 1000 app
USER app
# Устанавливаем рабочую директорию
WORKDIR /app
Dockerfile.cli-dev - это наш консольный php для запуска консольных команд. Тут практически то же самое, плюс тот самый Composer, ради которого это всё и писалось)
# Образ php-cli
FROM php:8.2-cli
ARG IMAGE_ENV
# Устанавливаем нужные пакеты и расширения
RUN apt-get update && apt-get install -y -qq git unzip libpq-dev libxml2-dev libicu-dev librabbitmq-dev && \
docker-php-ext-configure pdo_mysql --with-pdo-mysql=mysqlnd && docker-php-ext-install pdo_mysql && \
docker-php-ext-configure intl && docker-php-ext-install intl && \
pecl install xdebug amqp && rm -rf /tmp/pear && docker-php-ext-enable xdebug amqp && \
rm -rf /var/lib/apt/lists/*
# Use the default development configuration
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
# Копируем файл с настройками xdebug
COPY ./php.d/${IMAGE_ENV}/default.ini /usr/local/etc/php/conf.d/default.ini
COPY ./php.d/${IMAGE_ENV}/xdebug.ini /usr/local/etc/php/conf.d/xdebug.ini
# Качаем и устанавливаем composer
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/bin --filename=composer --quiet
# Если всё же будете работать в контейнере под рутом, то заставляем composer работать под рутом
# ENV COMPOSER_ALLOW_SUPERUSER 1
# Создаем пользователя app, чтобы не работать под рутом
RUN adduser --disabled-password --gecos '' --uid 1000 app
USER app
# Устанавливаем рабочую директорию
WORKDIR /app
3. И далее звезда шоу -
Makefile с кучей разных скриптов, облегчающих жизнь.
make init - чистая сборка проекта, тут можно очищать базу и загружать в нее фикстуры
make up - просто запуск проекта, без очистки, перед началом обычного рабочего дня.
make down - остановка проекта
make cc - очистка кэша Symfony.
И т.д. и т.п.
# Если надо подключить shell переменные, то создаём тут же ..env.local файл и делаем.
include .env.local
export
# Поддержка возможности запускать шелл-скрипты
SHELL:=/bin/bash
# Кэш
c: cache-clear cache-warmup
cc: cache-clear
cw: cache-warmup
cache-clear:
docker-compose run --rm php-cli bin/console c:c
cache-warmup:
docker-compose run --rm php-cli bin/console c:w
up: docker-up
down: docker-down
restart: docker-down docker-up
init: docker-down init-common
reset: docker-down-clear init-common
init-common: clear docker-pull docker-build docker-up app-init
test: test
test-coverage: test-coverage
test-unit: test-unit
test-unit-coverage: test-unit-coverage
# Если в контейнере другой пользователь, то будут ошибки доступа при редактировании файлов.
# Поэтому надо сделать chown и chmod для папки var (кэш и логи)
chown:
sudo chown -R 1000:1000 . # Тут указываем свои данные пользователя с хоста
sudo chmod -R 777 ./var/
docker-up:
docker-compose up -d
docker-down:
docker-compose down --remove-orphans
docker-down-clear:
docker-compose down -v --remove-orphans
docker-pull:
docker-compose pull
docker-build:
docker-compose build
app-init: composer-install app-wait-db app-migrations ready
clear:
docker run --rm -v ${PWD}:/app --workdir=/app alpine rm -f .ready
ready:
docker run --rm -v ${PWD}:/app --workdir=/app alpine touch .ready
test:
docker-compose run --rm php-cli php bin/phpunit
test-coverage:
docker-compose run --rm php-cli php bin/phpunit --coverage-clover var/clover.xml --coverage-html var/coverage
test-unit:
docker-compose run --rm php-cli php bin/phpunit --testsuite=unit
test-unit-coverage:
docker-compose run --rm php-cli php bin/phpunit --testsuite=unit --coverage-clover var/clover.xml --coverage-html var/coverage
composer-install:
docker-compose run --rm php-cli composer -V
docker-compose run --rm php-cli composer install
app-create-db:
docker-compose run --rm php-cli ./bin/console doctrine:database:create
app-wait-db:
#docker-compose exec lkui-mysql mysqladmin --user=root --password=password ping --silent --wait=60 &> /dev/null
#sleep 20
until docker-compose exec -T mysql mysqladmin ping -u root -P ${MYSQL_TCP_PORT} -p${MYSQL_ROOT_PASSWORD} | grep "mysqld is alive" ; do >&2 echo "MySQL is unavailable - waiting for it... " ; sleep 5 ; done
app-migrations:
docker-compose run --rm php-cli ./bin/console doctrine:migrations:migrate --no-interaction
app-fixtures:
docker-compose run --rm php-cli ./bin/console doctrine:fixtures:load --no-interaction
migration:
docker-compose run --rm php-cli ./bin/console make:migration
migrate:
docker-compose run --rm php-cli ./bin/console doctrine:migrations:migrate #--no-interaction
fixtures:
docker-compose run --rm php-cli ./bin/console doctrine:fixtures:load
Средний
Простой
Сложный
