秒懂Docker 中安装扩展 PHP

为了保证 Docker 镜像尽量小，PHP 的源文件是以压缩包的形式存在镜像中，官方提供了 docker-php-source 快捷脚本，用于对源文件压缩包的解压（extract）及解压后的文件进行删除（delete）的操作。

示例：

FROM php:7.1-apache
RUN docker-php-source extract /
    # 此处开始执行你需要的操作 /
    && docker-php-source delete

注意：一定要记得删除，否则解压出来的文件会大大增加镜像的文件大小。

这里主要用到的是官方提供的 docker-php-ext-configure 和 docker-php-ext-install 快捷脚本，如下

FROM php:7.1-fpm
RUN apt-get update /
	# 相关依赖必须手动安装
	&& apt-get install -y /
        libfreetype6-dev /
        libjpeg62-turbo-dev /
        libmcrypt-dev /
        libpng-dev /
    # 安装扩展
    && docker-php-ext-install -j$(nproc) iconv mcrypt /
    # 如果安装的扩展需要自定义配置时
    && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ /
    && docker-php-ext-install -j$(nproc) gd

注意：这里的 docker-php-ext-configure 和 docker-php-ext-install 已经包含了 docker-php-source 的操作，所有不需要再手动去执行。

因为一些扩展并不包含在 PHP 源码文件中，所有需要使用 PECL（PHP 的扩展库仓库，通过 PEAR 打包）。用 pecl install 安装扩展，然后再用官方提供的 docker-php-ext-enable 快捷脚本来启用扩展，如下示例

FROM php:7.1-fpm
RUN apt-get update /
	# 手动安装依赖
	&& apt-get install -y libmemcached-dev zlib1g-dev /
	# 安装需要的扩展
   && pecl install memcached-2.2.0 /
   # 启用扩展
   && docker-php-ext-enable memcached

一些既不在 PHP 源码包，也不再 PECL 扩展仓库中的扩展，可以通过下载扩展程序源码，编译安装的方式安装，如下示例：

FROM php:5.6-apache
RUN curl -fsSL 'https://xcache.lighttpd.net/pub/Releases/3.2.0/xcache-3.2.0.tar.gz' -o xcache.tar.gz /
    && mkdir -p xcache /
    && tar -xf xcache.tar.gz -C xcache --strip-components=1 /
    && rm xcache.tar.gz /
    && ( /
        cd xcache /
        && phpize /
        && ./configure --enable-xcache /
        && make -j$(nproc) /
        && make install /
    ) /
    && rm -r xcache /
    && docker-php-ext-enable xcache

注意：官方提供的 docker-php-ext-* 脚本接受任意的绝对路径（不支持相对路径，以便与系统内置的扩展程序进行区分），所以，上面的例子也可以这样写：

FROM php:5.6-apache
RUN curl -fsSL 'https://xcache.lighttpd.net/pub/Releases/3.2.0/xcache-3.2.0.tar.gz' -o xcache.tar.gz /
    && mkdir -p /tmp/xcache /
    && tar -xf xcache.tar.gz -C /tmp/xcache --strip-components=1 /
    && rm xcache.tar.gz /
    && docker-php-ext-configure /tmp/xcache --enable-xcache /
    && docker-php-ext-install /tmp/xcache /
    && rm -r /tmp/xcache