PHP Build镜像文档

概述

PHP Build镜像是专为PHP应用构建设计的环境镜像，集成完整的构建工具链，旨在简化PHP项目从依赖管理、扩展编译到应用打包的全流程。该镜像提供标准化构建环境，避免因本地环境差异导致的构建问题，广泛适用于开发和自动化构建场景。

核心功能和特性

多版本PHP支持

• 内置多种稳定PHP版本（7.4/8.0/8.1/8.2等），通过镜像标签灵活切换
• 预配置PHP核心扩展，支持动态安装第三方扩展

完整依赖管理工具链

• 集成Composer（最新稳定版），支持依赖安装、更新、打包及自动加载优化
• 包含PECL工具，支持PHP扩展的编译与安装
• 内置git、curl、unzip等基础工具，满足资源获取需求

构建优化特性

• 轻量级基础镜像，减少构建环境体积
• 预配置编译工具（gcc、make、autoconf等），支持源码编译扩展
• 支持多平台架构（Linux/amd64、Linux/arm64）

开发友好设计

• 兼容PHP-FPM和CLI模式
• 支持自定义php.ini配置
• 提供环境变量控制构建行为

使用场景

CI/CD流程集成

在Jenkins、GitHub Actions等CI/CD平台中，用于自动化执行PHP项目构建步骤（如依赖安装、代码检查、扩展编译）。

本地开发构建

本地开发环境中，快速复现标准化构建流程，避免"在我电脑上能运行"的环境差异问题。

应用打包场景

作为多阶段构建的基础镜像，用于生成包含依赖的PHP应用 artifacts（如PHAR包、Docker镜像）。

使用方法和配置说明

基础使用命令

通过docker run启动容器，挂载项目目录并执行构建操作：

# 安装项目依赖（Composer）
docker run --rm -v $(pwd):/app -w /app php-build:latest composer install

# 编译安装PHP扩展（以redis为例）
docker run --rm -v $(pwd):/app -w /app php-build:latest sh -c "pecl install redis && docker-php-ext-enable redis"

参数说明：

• --rm：容器退出后自动清理
• -v $(pwd):/app：挂载当前目录（PHP项目根目录）至容器内/app
• -w /app：设置工作目录为/app
• php-build:latest：使用最新版本镜像（可替换为具体版本标签如8.2）

指定PHP版本

通过镜像标签选择PHP版本，格式为php-build:<php-version>：

# 使用PHP 8.2环境安装依赖
docker run --rm -v $(pwd):/app -w /app php-build:8.2 composer install

自定义PHP配置

通过挂载本地php.ini配置文件覆盖默认配置：

docker run --rm -v $(pwd):/app -v $(pwd)/php.ini:/usr/local/etc/php/php.ini -w /app php-build:latest php -i | grep memory_limit

环境变量配置

支持通过环境变量调整构建行为，常用变量如下：

示例：自定义Composer缓存目录

docker run --rm \
  -v $(pwd):/app \
  -v /custom/composer-cache:/composer-cache \
  -e COMPOSER_HOME=/composer-cache \
  -w /app \
  php-build:latest \
  composer install

多阶段构建示例（Dockerfile）

结合多阶段构建生成最小化PHP应用镜像：

# 阶段1：使用PHP Build镜像安装依赖
FROM php-build:8.2 AS builder
WORKDIR /app
COPY composer.json composer.lock ./
RUN composer install --no-dev --optimize-autoloader --no-scripts

# 阶段2：构建运行时镜像
FROM php:8.2-fpm-alpine
COPY --from=builder /app/vendor /var/www/vendor
COPY . /var/www
WORKDIR /var/www
EXPOSE 9000
CMD ["php-fpm"]