Настройка Docker-окружения для разработки на Битрикс

project/
├── docker/
│   ├── nginx/
│   │   └── default.conf
│   ├── php/
│   │   ├── Dockerfile
│   │   └── php.ini
│   └── mysql/
│       └── my.cnf
├── src/                    # Корень Битрикс
│   ├── bitrix/
│   ├── local/
│   └── index.php
├── docker-compose.yml
└── Makefile               # Удобные команды

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./src:/var/www/html
      - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - php
  php:
    build:
      context: ./docker/php
      dockerfile: Dockerfile
    volumes:
      - ./src:/var/www/html
      - ./docker/php/php.ini:/usr/local/etc/php/php.ini
    environment:
      # trigger вместо постоянно включённой отладки: xdebug стартует
      # только при явном запросе из IDE и не замедляет обычную работу
      XDEBUG_MODE: debug,develop
      XDEBUG_CONFIG: "client_host=host.docker.internal start_with_request=trigger"
  mysql:
    image: mysql:8.0
    # Битриксу нужен нестрогий sql_mode, иначе часть запросов ядра
    # падает на ONLY_FULL_GROUP_BY и STRICT_TRANS_TABLES
    command: >
      --sql-mode=""
      --character-set-server=utf8mb4
      --collation-server=utf8mb4_unicode_ci
    ports:
      # Слушаем только localhost: иначе база проекта торчит наружу,
      # а порт конфликтует с соседними проектами
      - "127.0.0.1:3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: bitrix
    volumes:
      - mysql_data:/var/lib/mysql
      - ./docker/mysql/my.cnf:/etc/mysql/conf.d/my.cnf
  redis:
    image: redis:alpine
    ports:
      - "127.0.0.1:6379:6379"
volumes:
  mysql_data:

FROM php:8.1-fpm
# Системные зависимости
RUN apt-get update && apt-get install -y \
    libfreetype6-dev \
    libjpeg62-turbo-dev \
    libpng-dev \
    libzip-dev \
    libicu-dev \
    && rm -rf /var/lib/apt/lists/*
# PHP-расширения для Битрикс
RUN docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) \
        gd \
        mysqli \
        pdo_mysql \
        opcache \
        intl \
        zip \
        exif
# Redis
RUN pecl install redis && docker-php-ext-enable redis
# Xdebug (только для разработки!)
RUN pecl install xdebug && docker-php-ext-enable xdebug
WORKDIR /var/www/html

server {
    listen 80;
    server_name localhost;
    root /var/www/html;
    index index.php;
    # Битрикс urlrewrite
    location / {
        try_files $uri $uri/ @bitrix;
    }
    location @bitrix {
        fastcgi_pass php:9000;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root/bitrix/urlrewrite.php;
    }
    location ~ \.php$ {
        # Без try_files nginx отдаёт в PHP-FPM любой запрос, оканчивающийся
        # на .php, включая несуществующие пути вида /upload/pic.jpg/x.php
        try_files $uri =404;

        fastcgi_pass php:9000;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
    # Запрет доступа к служебным файлам
    location ~ /\.(ht|git) {
        deny all;
    }
}

up:
	docker-compose up -d
down:
	docker-compose down
restart:
	docker-compose restart
logs:
	docker-compose logs -f
shell:
	docker-compose exec php bash
mysql:
	docker-compose exec mysql mysql -uroot -proot bitrix
# Бэкап базы. Флаг -T обязателен: без него docker-compose выделяет
# псевдотерминал и дописывает в поток \r, ломая дамп
backup:
	docker-compose exec -T mysql mysqldump -uroot -proot bitrix > backup.sql
# Восстановление
restore:
	docker-compose exec -T mysql mysql -uroot -proot bitrix < backup.sql

# В Dockerfile: подгоняем UID www-data под пользователя хоста
ARG UID=1000
RUN usermod -u ${UID} www-data && groupmod -g ${UID} www-data

# В docker-compose.yml передаём UID хоста при сборке
php:
  build:
    context: ./docker/php
    args:
      UID: ${UID:-1000}

memory_limit = 512M
max_execution_time = 300
post_max_size = 100M
upload_max_filesize = 100M
max_input_vars = 10000