lucatume/codeception

lucatume/codeception 镜像文档

镜像概述

lucatume/codeception是默认Codeception容器的扩展镜像，主要用于在Docker环境中运行WordPress项目的Codeception测试。该镜像设计为轻量级，不包含测试所需的全部依赖（如wp-browser），需作为docker-compose栈的一部分与其他服务（如数据库、Web服务器、浏览器）配合使用。

核心功能和特性

• Codeception测试支持：可直接运行Codeception的各类测试命令（如验收测试、功能测试等）
• WordPress测试适配：针对WordPress项目测试场景优化，支持通过环境变量配置数据库连接
• 数据库等待机制：当传入WORDPRESS_DB_或WP_DB_前缀的环境变量时，容器会先等待数据库可用后再执行测试命令
• 轻量级设计：不包含所有测试依赖，需配合docker-compose栈中的其他服务（如数据库、浏览器）使用

使用场景

• WordPress项目的自动化测试（验收测试、集成测试等）
• 需要隔离测试环境的PHP项目测试
• 持续集成/持续部署(CI/CD)流程中的自动化测试环节

使用方法

基本使用

1. 拉取镜像：

bash
docker pull lucatume/codeception

2. 运行测试（需挂载项目目录）：

bash
docker run --rm -v $(pwd):/project lucatume/codeception run acceptance

Docker Compose配置示例

推荐作为docker-compose栈的一部分使用，以下是完整的WordPress测试环境配置示例：

yaml
version: "3"

networks:
  test:  # 定义测试网络，使各服务可相互访问

services:
  # 数据库服务
  db:
    networks:
      - test
    image: mariadb  # 使用MariaDB作为数据库
    environment:
      MYSQL_ROOT_PASSWORD: password  # 数据库root密码

  # WordPress服务
  wordpress:
    networks:
      - test
    image: wordpress  # WordPress官方镜像
    depends_on:
      - db  # 依赖数据库服务
    environment:
      WORDPRESS_DB_NAME: test  # 数据库名称
      WORDPRESS_DB_HOST: db  # 数据库主机地址（服务名）
      WORDPRESS_DB_USER: root  # 数据库用户名
      WORDPRESS_DB_PASSWORD: password  # 数据库密码
    volumes:
      - ./vendor/wordpress/wordpress:/var/www/html  # 挂载WordPress代码目录

  # 浏览器服务（用于验收测试）
  chrome:
    networks:
      - test
    image: selenium/standalone-chrome:3.141.59-oxygen  # Selenium Chrome浏览器

  # Codeception测试服务
  codeception:
    networks:
      - test
    image: lucatume/codeception
    environment:
      # 数据库连接配置（触发等待数据库可用机制）
      WORDPRESS_DB_NAME: test
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: root
      WORDPRESS_DB_PASSWORD: password
    depends_on:
      - wordpress  # 依赖WordPress服务
      - chrome  # 依赖浏览器服务
    volumes:
      - .:/project  # 挂载当前项目目录到容器内/project

配置说明

环境变量

容器通过环境变量控制数据库等待行为：

• WORDPRESS_DB_* 或 WP_DB_*：当传入完整的WordPress数据库凭证（名称、主机、用户、密码）时，容器会在运行测试命令前等待数据库服务可用。常用变量包括：
  • WORDPRESS_DB_NAME：数据库名称
  • WORDPRESS_DB_HOST：数据库主机地址
  • WORDPRESS_DB_USER：数据库用户名
  • WORDPRESS_DB_PASSWORD：数据库密码

若未传入完整的WordPress数据库凭证，容器将直接执行codecept命令，不等待数据库。

卷挂载

• 项目目录挂载：需将本地项目目录挂载到容器内/project路径，命令示例：-v $(pwd):/project，确保容器可访问项目中的测试代码和配置文件。