quiqqer/testing

QUIQQER 测试镜像文档

镜像概述

该镜像基于QUIQQER生产镜像构建，但针对（自动化）测试目的进行了优化和调整。提供预安装和预配置的QUIQQER系统及数据库，可消除测试（如在CI环境中）时安装QUIQQER的额外开销。注意：不应将此镜像用于生产环境，因其未针对性能和安全性进行优化。

核心功能与特性

• 预安装和预配置的QUIQQER系统及数据库，减少测试环境准备时间
• 适配自动化测试和CI流水线，简化测试流程
• 支持通过构建参数自定义QUIQQER系统配置
• 集成多种测试所需工具，满足CI环境中的各类测试需求

使用场景

• 自动化测试环境搭建
• CI/CD流水线中的集成测试
• 开发阶段快速部署测试环境
• QUIQQER插件或主题的自动化测试

使用方法

手动运行容器

可通过docker run命令手动运行容器：

shell
docker run \
  --detach \
  --name quiqqer-testing \
  quiqqer/testing:php-8.3

通过docker compose自动运行

可使用compose.yaml文件，通过单条命令启动：

shell
docker compose up

构建参数

可通过构建参数自定义镜像中安装的QUIQQER系统类型。

注意：以下列表可能已过时，请查看Dockerfile顶部获取所有支持的构建参数。

所有构建参数均为可选，未指定时使用默认值。

• PHP_VERSION：PHP版本，格式为x.y（x为主版本，y为次版本，如8.1，默认：8.3）
• QUIQQER_VERSION：要安装的QUIQQER主版本（如1或2，默认：2）
• QUIQQER_LANGUAGE：QUIQQER安装语言（如de或en，默认：en）
• QUIQQER_DB_DRIVER：QUIQQER使用的数据库驱动（默认：mysql）
• QUIQQER_DB_HOST：数据库主机（默认：127.0.0.1）
• QUIQQER_DB_USER：数据库连接用户名（默认：quiqqer）
• QUIQQER_DB_PASSWORD：数据库连接密码（默认：quiqqer）
• QUIQQER_DB_NAME：安装QUIQQER的数据库名称（默认：quiqqer）
• QUIQQER_DB_PREFIX：所有QUIQQER数据库表的前缀（默认：无）
• QUIQQER_DB_PORT：数据库服务器端口（默认：3306）
• QUIQQER_ADMIN_USER：QUIQQER管理员用户名（默认：admin）
• QUIQQER_ADMIN_PASSWORD：QUIQQER管理员密码（默认：admin）
• QUIQQER_PROJECT_NAME：默认QUIQQER项目名称（默认：QUIQQER）

构建示例：构建具有以下属性的quiqqer/testing镜像：

• PHP版本：8.1
• QUIQQER版本：2
• 语言：德语
• 管理员用户：administrator
• 管理员密码：123456
• 项目名称：MyProject

使用以下命令：

shell
docker build . \
    --build-arg PHP_VERSION=8.1 \
    --build-arg=QUIQQER_VERSION=2 \
    --build-arg=QUIQQER_LANGUAGE=de \
    --build-arg=QUIQQER_ADMIN_USER=administrator \
    --build-arg=QUIQQER_ADMIN_PASSWORD=123456 \
    --build-arg=QUIQQER_PROJECT_NAME=MyProject

预装软件

该镜像预装了以下软件（详见Dockerfile获取完整列表）：

• PHP及部分扩展
• PHIVE：PHAR包管理器
• install-quiqqer-package-from-folder：从文件夹将包安装到QUIQQER系统（如在CI中）
• MariaDB
• git
• GPG
• sudo：以root用户执行命令（无需密码）