b13gmbh/php-builder

PHP 项目构建与测试镜像

镜像概述

该镜像是一个轻量级PHP开发环境，基于Alpine Linux构建，专为PHP项目的构建和测试流程设计。集成了PHP运行时、Composer依赖管理工具、Imagick图像处理库及Rclone文件同步工具，提供一站式开发测试解决方案，简化项目构建链路。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低，启动速度快
• 完整PHP环境：包含PHP运行时及常用扩展，满足标准PHP项目需求
• 依赖管理：集成Composer工具，支持PHP项目依赖的安装、更新与管理
• 图像处理：内置Imagick库，支持多种图像格式处理（缩放、裁剪、格式转换等）
• 文件同步：集成Rclone工具，支持与主流云存储服务（S3、Google Drive、Dropbox等）进行文件同步

使用场景与适用范围

• PHP项目构建流程：依赖安装、autoload文件生成、代码检查
• 单元测试与集成测试：运行PHPUnit等测试框架执行测试用例
• 图像处理任务：项目中图像资源的批量处理与优化
• 测试数据同步：通过Rclone同步测试环境数据或构建产物到云存储

使用方法与配置说明

基本使用（Docker Run）

1. 安装项目依赖

bash
docker run -v $(pwd):/app -w /app [镜像名称] composer install

• -v $(pwd):/app：将当前目录挂载到容器内/app目录
• -w /app：设置工作目录为/app
• composer install：执行依赖安装命令

2. 运行单元测试

bash
docker run -v $(pwd):/app -w /app [镜像名称] php vendor/bin/phpunit tests/

3. 图像处理示例

bash
docker run -v $(pwd):/app -w /app [镜像名称] convert input.png -resize 800x600 output.png

4. 文件同步到云存储

bash
# 挂载本地Rclone配置文件并同步
docker run -v $(pwd):/app \
  -v ~/.config/rclone:/root/.config/rclone \
  -w /app \
  [镜像名称] \
  rclone sync ./build remote:my-bucket/build

Docker Compose配置示例

yaml
version: '3.8'
services:
  php-build:
    image: [镜像名称]
    volumes:
      - ./:/app                   # 挂载项目代码
      - ~/.composer/cache:/root/.composer/cache  # 共享Composer缓存
      - ~/.config/rclone:/root/.config/rclone    # 挂载Rclone配置
    working_dir: /app
    command: >
      sh -c "composer install && 
             php vendor/bin/phpunit && 
             rclone sync ./coverage remote:test-reports/coverage"

配置参数说明

• PHP版本控制：通过镜像标签指定PHP版本（如:8.2表示PHP 8.2，具体版本需参考镜像标签列表）
• Composer缓存：挂载~/.composer/cache可加速依赖安装，避免重复下载
• Rclone配置：需提前在本地配置Rclone（执行rclone config），然后通过卷挂载配置文件
• 自定义PHP扩展：可基于此镜像构建新镜像，通过docker-php-ext-install添加额外扩展

环境变量

• COMPOSER_ALLOW_SUPERUSER=1：允许root用户运行Composer（默认已配置）
• PHP_MEMORY_LIMIT：设置PHP内存限制（默认128M，可通过-e PHP_MEMORY_LIMIT=256M调整）
• RCLONE_CONFIG：直接指定Rclone配置内容（替代文件挂载方式）