mlocati/php-extension-installer

镜像概述和主要用途

该Docker容器包含专用脚本，旨在简化官方PHP Docker镜像中PHP扩展的安装流程。通过自动化依赖管理与镜像清理，解决了手动安装扩展时依赖处理复杂、镜像体积过大等问题，适用于需要精简Docker镜像的开发与生产环境。

核心功能和特性

• 自动依赖管理：根据目标PHP镜像的系统（Alpine或Debian），自动识别并安装所需的APT/APK依赖包，无需手动配置。
• 镜像体积优化：扩展安装完成后，自动移除不再需要的依赖包、编译工具及临时文件，显著减小最终镜像体积。
• 版本兼容性：支持多种官方PHP Docker镜像版本，适配不同系统和PHP运行环境。

支持的镜像版本

• 常规支持：所有基于Alpine或Debian系统的官方PHP Docker镜像（包括apache、cli、fpm、zts等变体）。
• 特殊说明：PHP 5.5版本仅支持Debian 8（jessie）系统，具体镜像标签包括：php:5.5、php:5.5-apache、php:5.5-cli、php:5.5-fpm、php:5.5-zts。

使用场景和适用范围

适用于基于官方PHP Docker镜像构建应用的场景，尤其是：

• 需要快速集成特定PHP扩展（如gd、pdo_mysql、redis等）的开发或生产环境。
• 对Docker镜像体积有严格要求，希望避免手动清理依赖导致冗余的场景。
• 需要跨Alpine/Debian系统统一扩展安装流程的场景。

使用方法示例

以下是在Dockerfile中集成该工具安装PHP扩展的基本示例：

dockerfile
# 基于官方PHP镜像构建（以PHP 8.2-fpm为例）
FROM php:8.2-fpm

# 下载安装脚本并赋予执行权限
ADD https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
RUN chmod +x /usr/local/bin/install-php-extensions

# 安装所需PHP扩展（示例：安装gd和pdo_mysql扩展）
RUN install-php-extensions gd pdo_mysql

参考链接

• 源码仓库及详细文档：https://github.com/mlocati/docker-php-extension-installer#readme