Контейнеризация PHP с помощью Docker: от базового образа до production-сборки

Расширенные примеры сборки Docker образа PHP

В этом разделе представлены нестандартные сценарии использования Docker образа PHP с подробными примерами и результатами.

Пример 1. Образ PHP-FPM с Nginx и поддержкой PostgreSQL

Цель: запустить традиционный стек LEMP (Linux, Nginx, MySQL, PHP) на Docker. Вместо MySQL используем PostgreSQL.

Dockerfile для PHP:

FROM php:8.2-fpm-alpine
RUN apk add --no-cache postgresql-dev libpq-dev \
    && docker-php-ext-install pdo pdo_pgsql \
    && apk del postgresql-dev libpq-dev
COPY . /var/www/html

docker-compose.yml:

version: '3.8'
services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
      - ./src:/var/www/html
    depends_on:
      - php
  php:
    build: .
    volumes:
      - ./src:/var/www/html
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=app
      - DB_USER=user
      - DB_PASSWORD=pass
    depends_on:
      - postgres
  postgres:
    image: postgres:15-alpine
    environment:
      - POSTGRES_DB=app
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata:

Результат: после docker-compose up -d сайт доступен на localhost. PHP успешно подключается к PostgreSQL через PDO.

# Проверка подключения из PHP-контейнера:
docker exec -it php_container php -r "echo extension_loaded('pdo_pgsql') ? 'OK' : 'FAIL';"
# Вывод: OK

Пример 2. Установка Xdebug для отладки

Xdebug полезен при разработке. Его включение в Docker образ требует настройки как расширения, так и параметров IDE.

Dockerfile для разработки:

FROM php:8.2-fpm-alpine
RUN apk add --no-cache $PHPIZE_DEPS \
    && pecl install xdebug \
    && docker-php-ext-enable xdebug
COPY . /var/www/html

docker-compose.override.yml (для dev):

version: '3.8'
services:
  php:
    environment:
      - XDEBUG_MODE=debug
      - XDEBUG_START_WITH_REQUEST=yes
      - XDEBUG_SESSION=PHPSTORM
    extra_hosts:
      - "host.docker.internal:host-gateway"

Результат: при открытии страницы с браузером, в котором включен Xdebug (расширение), IDE (PhpStorm, VS Code) ловит точки останова.

# Проверка, что Xdebug активен:
docker exec -it php_container php -v
# PHP 8.2.x (cli) (built: ... )
# with Xdebug v3.2.x, Copyright (c) 2002-2023, by Derick Rethans

# Информация о настройках:
docker exec -it php_container php -i | grep xdebug
# (список директив)

Пример 3. Запуск cron-задач внутри PHP контейнера

Для выполнения периодических задач (например, очистка кэша) можно использовать crond в том же контейнере или отдельный образ.

Dockerfile с cron:

FROM php:8.2-cli-alpine
RUN apk add --no-cache dcron
COPY crontab /etc/crontabs/www-data
RUN chmod 0644 /etc/crontabs/www-data
COPY . /app
WORKDIR /app
CMD crond -l 2 -f

crontab:

* * * * * php /app/artisan schedule:run >> /dev/null 2>&1

Результат: каждую минуту выполняется artisan-команда Laravel. Логи выводятся в stdout (но в примере они перенаправлены в /dev/null, для отладки можно перенаправить в лог).

# Проверка работы cron:
docker logs -f cron_container
# Появится вывод при запуске crond (если не перенаправлен)

Пример 4. Использование образа с специфическими расширениями: imagick и gd

Иногда требуется одновременно установить несколько расширений для работы с изображениями.

Dockerfile:

FROM php:8.2-fpm-alpine
RUN apk add --no-cache imagemagick-dev imagemagick libpng-dev libjpeg-turbo-dev \
    && pecl install imagick \
    && docker-php-ext-enable imagick \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install gd \
    && apk del imagemagick-dev libpng-dev libjpeg-turbo-dev

Результат: в контейнере доступны оба расширения.

# Список установленных расширений:
docker exec -it php_container php -m | grep -E 'imagick|gd'
imagick
gd

Пример 5. Минимальный образ для CLI с оптимизацией размера

Использование php:8.2-cli-alpine и удаление ненужных файлов может уменьшить образ до 50 МБ.

FROM php:8.2-cli-alpine
RUN apk add --no-cache --virtual .builddeps $PHPIZE_DEPS \
    && docker-php-ext-install pcntl \
    && apk del .builddeps \
    && rm -rf /tmp/* /var/cache/apk/*
COPY my_script.php /app/
WORKDIR /app
CMD ["php", "my_script.php"]

Результат: итоговый размер образа около 30-40 МБ.

# Проверка размера образа:
docker images my-php-cli
REPOSITORY    TAG       IMAGE ID       CREATED         SIZE
my-php-cli    latest    abcdef123456   10 seconds ago  38.2MB

Примечание:

Все примеры предполагают, что приложение написано с учетом окружения Docker. Рекомендуется использовать переменные окружения для конфигурации, читать их через getenv() или библиотеки (например, phpdotenv). Также стоит обратить внимание на логирование: stdout/stderr контейнера собираются Docker демоном и доступны через docker logs.