10up/wordpress-ci

WordPress持续集成容器

镜像概述

本镜像为WordPress项目提供专用的持续集成环境，集成了一套常用的构建工具，旨在简化WordPress主题、插件及核心项目的自动化构建、测试与部署流程。通过预配置的开发环境，开发者可快速接入CI/CD pipeline，减少环境配置时间，专注于代码开发与质量控制。

核心功能与特性

• 多工具集成：包含PHP（多版本支持）、Node.js、Composer、WP-CLI、Git、PHPUnit、ESLint等常用开发与构建工具
• CI流程支持：原生支持自动化测试（单元测试、集成测试）、代码质量检查（linting、静态分析）、资产构建（CSS/JS压缩、打包）
• 环境一致性：标准化开发环境，避免"本地能跑，CI失败"的环境差异问题
• 轻量级设计：基于Alpine或Debian slim基础镜像，平衡功能与镜像大小
• 灵活配置：支持通过环境变量自定义工具版本、构建参数及测试策略

使用场景

• WordPress主题/插件开发的自动化测试与构建
• 多环境（开发/测试/生产）部署前的代码验证
• 团队协作中的代码质量门禁（如提交前自动lint、测试）
• WordPress核心二次开发的持续集成流程
• 开源WordPress项目的自动化发布流程

使用方法与配置说明

基础使用（Docker Run）

bash
docker run -it --rm \
  -v /path/to/your/wordpress/project:/app \
  -e WP_VERSION=6.4 \
  -e PHP_VERSION=8.2 \
  docker.xuanyuan.run/wordpress-ci-container:latest \
  /bin/bash

进入容器后，可直接使用集成工具进行开发操作，如：

bash
# 安装PHP依赖
composer install

# 安装Node.js依赖
npm install

# 运行PHPUnit测试
phpunit

# 构建前端资产
npm run build

Docker Compose配置

yaml
version: '3.8'
services:
  wp-ci:
    image: docker.xuanyuan.run/wordpress-ci-container:latest
    volumes:
      - ./your-wp-project:/app
    environment:
      - WP_VERSION=6.4
      - PHP_VERSION=8.2
      - NODE_VERSION=18
      - COMPOSER_NO_INTERACTION=1
    command: >
      sh -c "composer install && 
             npm install && 
             npm run lint && 
             phpunit"

关键环境变量配置

典型CI流程示例（GitHub Actions）

yaml
name: WordPress CI

on: [push, pull_request]

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Run WordPress CI container
        uses: docker://wordpress-ci-container:latest
        with:
          args: sh -c "composer install && npm install && npm run test && phpunit"

注意事项

• 本地开发时建议将项目目录挂载到容器内，避免重复构建镜像
• 生产环境部署前需确保CI流程包含安全扫描（如依赖漏洞检查）
• 如需自定义工具版本，可通过Dockerfile基于本镜像二次构建，或通过环境变量覆盖默认配置
• 大型项目建议配合持久化卷（Volume）缓存依赖（如node_modules、vendor）以提升构建速度