Добавление PHP-расширений в Docker-образы

Как установить расширения, отсутствующие в списке docker-php-ext-install (например, redis, xdebug)?

Для расширений, которые не входят в стандартный набор исходников PHP, используется pecl. В официальном образе PHP доступен скрипт docker-php-pecl-install, который оборачивает вызов pecl install и автоматически включает расширение.

FROM php:8.2-cli

# Установка зависимостей для pecl (git, zip)
RUN apt-get update && apt-get install -y git zip unzip \
&& rm -rf /var/lib/apt/lists/*

# Установка redis
RUN docker-php-pecl-install redis-5.3.7

# Установка xdebug
RUN docker-php-pecl-install xdebug-3.2.0

# Включение расширения (делается автоматически, но можно явно)
RUN docker-php-ext-enable redis xdebug

Ext http php (расширение http для php)

Как установить расширение, если оно доступно в виде системного пакета (например, php-mysql)?

Некоторые расширения можно установить через менеджер пакетов дистрибутива, например, apt-get для Debian/Ubuntu. Этот способ удобен, если расширение уже скомпилировано для вашей версии PHP. Однако следует использовать репозиторий sury.org для соответствия версии PHP.

FROM php:8.2-fpm

# Добавление репозитория sury.org (если используется Debian)
RUN apt-get update && apt-get install -y apt-transport-https lsb-release ca-certificates wget \
&& wget -qO- https://packages.sury.org/php/apt.gpg | apt-key add - \
&& echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list \
&& apt-get update

# Установка расширения из пакета (например, php-xml)
RUN apt-get install -y php8.2-xml

# Активация через docker-php-ext-enable (если пакет не включает ini)
RUN docker-php-ext-enable xml

Off php ext (отключение расширения php)

Как собрать расширение с нестандартными опциями компиляции (например, указать кастомные пути)?

Расширения, доступные на GitHub или других источниках, можно скачать, скомпилировать вручную с помощью phpize и configure. Затем установить через make install и включить через docker-php-ext-enable.

FROM php:8.2-cli

# Установка зависимостей для сборки
RUN apt-get update && apt-get install -y git autoconf libtool make gcc \
&& rm -rf /var/lib/apt/lists/*

# Клонирование исходников расширения (например, php-memcached)
RUN git clone https://github.com/php-memcached-dev/php-memcached.git /tmp/php-memcached

WORKDIR /tmp/php-memcached

# Запуск phpize и configure
RUN phpize && ./configure --with-libmemcached-dir=/usr --enable-memcached

# Компиляция и установка
RUN make && make install

# Включение расширения
RUN docker-php-ext-enable memcached

# Очистка
RUN rm -rf /tmp/php-memcached

Ext php install (установка расширения php)

Как минимизировать размер образа, если для компиляции расширения требуются объемные зависимости?

Многостадийная сборка позволяет собрать расширение в одном контейнере, а затем скопировать только скомпилированный .so файл в финальный минимальный образ. Это уменьшает итоговый размер, так как инструменты компиляции не попадают в финальный образ.

# Стадия сборки
FROM php:8.2-cli AS builder

RUN apt-get update && apt-get install -y libmagickwand-dev libpng-dev libjpeg-dev \
&& rm -rf /var/lib/apt/lists/*

# Сборка imagick из исходников
RUN git clone https://github.com/Imagick/imagick /tmp/imagick
WORKDIR /tmp/imagick
RUN phpize && ./configure && make && make install

# Финальный образ
FROM php:8.2-fpm

# Копирование только .so файла
COPY --from=builder /usr/local/lib/php/extensions/no-debug-non-zts-20220829/imagick.so /usr/local/lib/php/extensions/no-debug-non-zts-20220829/

# Включение расширения
RUN docker-php-ext-enable imagick