wordpressdevelop/phpunit

WordPress开发环境PHPUnit镜像

镜像概述

本镜像专为WordPress本地开发环境设计，集成PHPUnit测试工具，旨在为WordPress开发者提供便捷、一致的单元测试和集成测试环境。通过预配置的PHPUnit及相关依赖，开发者可快速对WordPress主题、插件等代码进行自动化测试，确保代码质量。

核心功能与特性

• 开箱即用：预装PHPUnit及WordPress测试框架依赖，无需手动配置测试环境
• 环境兼容：针对WordPress开发场景优化，支持WordPress主题、插件及核心功能的测试
• 多版本支持：提供多种PHP版本标签（如php7.4、php8.0等），适配不同WordPress兼容性需求
• 轻量设计：基于官方PHP镜像构建，精简镜像体积，提升本地运行效率
• 灵活配置：支持自定义测试命令、挂载项目目录及测试配置文件

使用场景

• WordPress主题开发：对主题功能模块（如模板渲染、钩子调用等）进行单元测试
• WordPress插件开发：验证插件功能逻辑、API调用及兼容性
• 本地CI流程：集成到本地开发工作流中，在代码提交前自动执行测试
• 多人协作：统一团队测试环境，避免因环境差异导致的测试结果不一致

使用方法与配置说明

基本使用（docker run）

通过以下命令启动容器并执行测试：

bash
docker run -it --rm \
  -v /path/to/your/wordpress/project:/app \  # 挂载本地WordPress项目目录
  -w /app/tests \  # 设置工作目录为测试文件所在路径
  wordpress-phpunit:php8.0 \  # 指定镜像标签（如php7.4、php8.1等）
  phpunit  # 执行PHPUnit测试命令

自定义测试配置

若项目使用自定义phpunit.xml配置文件，确保该文件位于挂载的项目目录中，PHPUnit将自动识别并应用配置：

bash
docker run -it --rm \
  -v /path/to/your/project:/app \
  -w /app \
  wordpress-phpunit:latest \
  phpunit --configuration phpunit.xml

常用环境变量

集成docker-compose

在docker-compose.yml中集成该镜像，与WordPress开发环境联动：

yaml
version: '3'
services:
  phpunit:
    image: wordpress-phpunit:php8.0
    volumes:
      - ./wp-content/plugins/your-plugin:/app
    working_dir: /app/tests
    depends_on:
      - wordpress  # 依赖WordPress数据库及核心服务
    environment:
      - WORDPRESS_PATH=/var/www/html

注意事项

• 确保本地项目目录结构符合PHPUnit测试规范（如测试文件位于tests/目录）
• 若测试依赖数据库，需提前启动WordPress数据库服务并配置数据库连接信息
• 不同PHP版本标签需对应项目的PHP兼容性要求，避免因版本差异导致测试失败