为了保证 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