Docker PHP 扩展安装器使用教程

项目介绍

docker-php-extension-installer 是一个开源项目，旨在简化在 Docker 容器中安装 PHP 扩展的过程。该项目提供了一个脚本，可以轻松地在官方 PHP Docker 镜像中安装各种 PHP 扩展。通过使用这个脚本，开发者可以避免手动编译和安装扩展的复杂过程，从而提高开发效率。

项目快速启动

安装脚本

你可以通过以下几种方式安装 docker-php-extension-installer 脚本：

使用 curl 直接下载

FROM php:7.2-cli
RUN curl -sSLf \
    -o /usr/local/bin/install-php-extensions \
    https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions && \
    chmod +x /usr/local/bin/install-php-extensions && \
    install-php-extensions gd xdebug

直接执行 curl 下载的脚本

FROM php:8.2-cli
RUN ( curl -sSLf https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions -o - || echo 'return 1' ) | sh -s \
    gd xdebug

从 Docker 镜像复制脚本

FROM php:7.2-cli
COPY --from=mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/local/bin/
RUN install-php-extensions gd xdebug

安装 PHP 扩展

在 Dockerfile 中使用 install-php-extensions 命令来安装所需的 PHP 扩展：

RUN install-php-extensions gd xdebug

应用案例和最佳实践

应用案例

假设你需要在一个基于 PHP 8.1 的 Docker 容器中安装 GD、intl、mysqli、pdo_mysql、zip 和 opcache 扩展。你可以按照以下步骤进行：

FROM php:8.1-fpm
RUN curl -sSLf \
    -o /usr/local/bin/install-php-extensions \
    https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions && \
    chmod +x /usr/local/bin/install-php-extensions && \
    install-php-extensions gd intl mysqli pdo_mysql zip opcache

最佳实践

1. 定期更新脚本：确保使用最新版本的 install-php-extensions 脚本，以支持最新的 PHP 扩展和功能。
2. 最小化镜像大小：仅安装必要的 PHP 扩展，避免不必要的依赖和库，以减小最终镜像的大小。
3. 使用多阶段构建：如果需要编译扩展，可以使用多阶段构建来减小最终镜像的大小。

典型生态项目

docker-php-extension-installer 与以下生态项目紧密相关：

1. 官方 PHP Docker 镜像：该项目主要用于在官方 PHP Docker 镜像中安装扩展。
2. Docker Compose：可以与 Docker Compose 结合使用，简化多容器应用的部署和管理。
3. Composer：PHP 的依赖管理工具，可以与 docker-php-extension-installer 结合使用，确保项目依赖的扩展和库都能正确安装。

通过这些生态项目的结合使用，可以构建一个高效、稳定的 PHP 开发和部署环境。