ukkocom/circle-v2-php

镜像概述

CircleCI Test Container with additional PHP extensions 是针对CircleCI环境设计的测试容器，基于官方CircleCI测试容器扩展，集成额外PHP扩展，主要用于PHP应用的持续集成/持续部署（CI/CD）流程。通过提供预配置的测试环境及扩展支持，简化PHP项目在CI/CD中测试、构建的依赖管理，确保测试环境一致性。

核心功能与特性

1. CircleCI环境兼容性

• 与CircleCI流水线无缝集成，支持主流CI/CD配置（如.circleci/config.yml），可直接作为测试步骤容器使用。

2. 额外PHP扩展支持

• 包含常用PHP扩展（如mysqli、gd、curl、mbstring、redis等），解决标准容器中扩展缺失导致的测试失败问题。
• 支持扩展按需启用，可通过配置灵活选择所需扩展。

3. 测试环境一致性

• 提供标准化测试环境，避免因本地与CI环境差异导致的“本地可运行，CI测试失败”问题。
• 基于轻量级基础镜像（如Alpine/Debian Slim），平衡功能与资源占用，提升CI流程效率。

4. 多PHP版本支持

• 提供多版本PHP标签（如7.4、8.0、8.1、8.2），适配不同PHP项目的版本需求。

使用场景

1. PHP项目持续集成测试

• 用于PHP应用的单元测试、集成测试，在CircleCI流水线中执行phpunit、codeception等测试框架命令。

2. 依赖特定PHP扩展的应用测试

• 针对依赖非标准扩展（如redis、imagick）的PHP项目，无需手动安装扩展即可完成测试。

3. 多版本PHP兼容性验证

• 通过指定不同镜像标签（如7.4、8.2），在同一CI流程中测试应用在多PHP版本下的兼容性。

4. 本地CI环境模拟

• 本地开发时运行容器，复现CircleCI测试环境，提前排查依赖或配置问题。

使用方法与配置说明

获取镜像

通过Docker Hub拉取镜像（需替换<tag>为目标PHP版本，如8.1）：

bash
docker pull circleci/test-container-php-extensions:<tag>

基本使用（Docker Run）

命令示例

bash
docker run -it --rm \
  -v $(pwd):/app \  # 挂载本地PHP项目目录至容器内/app
  -e PHP_VERSION=8.1 \  # 指定PHP版本（需与镜像标签一致）
  -e ENABLE_EXTENSIONS="mysqli,gd,redis" \  # 启用额外扩展
  -e TEST_COMMAND="composer test" \  # 自定义测试命令
  circleci/test-container-php-extensions:8.1

参数说明

• -v $(pwd):/app：挂载本地项目代码至容器，实现代码实时同步。
• 环境变量通过-e指定，具体说明见下文“环境变量配置”。

Docker Compose配置示例

适用于本地多容器测试场景（如搭配数据库容器）：

yaml
version: '3.8'
services:
  php-test:
    image: circleci/test-container-php-extensions:8.1
    volumes:
      - ./:/app  # 挂载项目代码
    environment:
      - PHP_VERSION=8.1
      - ENABLE_EXTENSIONS=mysqli,gd,redis  # 启用扩展
      - TEST_COMMAND="phpunit tests/"  # 执行单元测试
      - CIRCLECI_CACHE_DIR=/tmp/cache  # 缓存目录（如Composer依赖）
    depends_on:
      - mysql  # 依赖数据库容器时配置

  mysql:
    image: mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=test_db

环境变量配置

注意事项

1. 镜像标签与PHP版本对应：使用时需确保镜像标签（如8.1）与PHP_VERSION环境变量值一致，避免版本冲突。
2. 扩展兼容性：ENABLE_EXTENSIONS中指定的扩展需为镜像支持的扩展，可通过容器内执行php -m查看已安装扩展列表。
3. 缓存优化：在CI配置中挂载CIRCLECI_CACHE_DIR至CircleCI缓存目录（如.circleci/config.yml中的persist_to_workspace），可加速依赖安装。