Эффективное использование Composer и Docker для PHP-проектов

Расширенные примеры использования Composer в Docker

Multi-stage с кэшированием Composer через BuildKit

Использование BuildKit позволяет кэшировать установленные пакеты Composer между сборками, даже если изменился код приложения, но не файл composer.lock. Для этого нужно передать флаг --mount=type=cache.

# syntax=docker/dockerfile:experimental
FROM php:8.2-cli AS builder
WORKDIR /app
RUN apt-get update && apt-get install -y unzip git \
    && docker-php-ext-install pdo_mysql
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
COPY composer.json composer.lock ./
RUN --mount=type=cache,target=/root/.composer/cache \
    composer install --no-dev --prefer-dist --no-scripts --optimize-autoloader

FROM php:8.2-fpm-alpine
WORKDIR /app
COPY --from=builder /app/vendor ./vendor
COPY . .
CMD ["php-fpm"]

Результат: при повторной сборке без изменений composer.lock кэш не будет перезагружен, что сокращает время сборки на 50-80%.

Авторизация для частных репозиториев через auth.json

Для доступа к приватным пакетам (например, на Satis или Private Packagist) необходимо передать аутентификационные данные. Лучший способ - создать файл auth.json в корне проекта и скопировать его в builder.

# auth.json (не добавлять в git, использовать секреты CI)
{
    "http-basic": {
        "repo.example.com": {
            "username": "token",
            "password": "abc123"
        }
    }
}

# Dockerfile
COPY auth.json /app/auth.json
RUN composer install --no-dev

Результат: Composer использует учётные данные для доступа к защищённым репозиториям, не раскрывая их в образе (если удалить auth.json после установки).

Важно: на продакшене удалять auth.json из финального образа, чтобы не хранить пароли.

Оптимизация автозагрузчика и использование Horde/Parallel

Для ускорения установки зависимостей можно включить параллельную загрузку пакетов. В Composer 2 это уже включено, но в Docker можно дополнительно кэшировать пакеты.

# composer.json (пример дополнительных настроек)
{
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true
    }
}

# Команда установки с кэшированием через volume
RUN --mount=type=cache,target=/root/.composer/cache \
    composer install --no-dev --no-interaction --no-progress --optimize-autoloader --apcu-autoloader

Результат: автозагрузчик кэшируется в APCu (если расширение установлено), что повышает производительность приложения.

Интеграция с GitLab CI: параллельные сборки с Composer

В CI/CD удобно использовать слой кэширования Docker и отдельный этап для Composer. Пример .gitlab-ci.yml с кэшированием vendor.

stages:
  - build
  - test

variables:
  DOCKER_DRIVER: overlay2
  CACHE_FALLBACK_KEY: master

build:
  stage: build
  image: docker:20
  services:
    - docker:dind
  script:
    - docker build --cache-from $CI_REGISTRY_IMAGE:latest -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA .
  cache:
    key: ${CI_COMMIT_REF_SLUG}
    paths:
      - vendor/
    policy: pull-push

test:
  stage: test
  image: $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
  script:
    - vendor/bin/phpunit

Результат: кэш папки vendor сохраняется между сборками, что ускоряет pipeline.

Передача SSH-ключей для доступа к Git-репозиториям

Если зависимости хранятся в приватных Git-репозиториях, можно монтировать SSH-агент или ключи во время сборки.

# Dockerfile (строится с использованием docker build --ssh)
# syntax=docker/dockerfile:1
FROM php:8.2-cli AS builder
RUN apt-get update && apt-get install -y git openssh-client
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
RUN mkdir -p -m 0700 ~/.ssh && ssh-keyscan github.com >> ~/.ssh/known_hosts
COPY composer.* ./
RUN --mount=type=ssh \
    composer install --no-dev --prefer-dist

Выполнение сборки: DOCKER_BUILDKIT=1 docker build --ssh default . Ключи не остаются в образе.

Установка Composer в Alpine образ с минимальным набором расширений

Для ультралегких образов (например, php:8.2-cli-alpine) нужно самостоятельно устанавливать Composer, так как официальный образ Composer может быть несовместим с отсутствующими библиотеками.

FROM php:8.2-cli-alpine
RUN apk add --no-cache git unzip openssh \
    && curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer \
    && composer --version
WORKDIR /app
COPY . .
RUN composer install

Результат: образ размером около 150 МБ (без Alpine ещё меньше).

Эти примеры охватывают большинство сценариев использования Composer в Docker: от базового до продвинутого с кэшированием и безопасностью.