kirschbaumdevelopment/laravel-test-runner

Laravel测试运行容器

概述

该Docker容器专为运行Laravel项目测试设计，主要应用于CI/CD流程（尤其是GitHub Actions），同时兼容其他持续集成环境。镜像通过标签明确标识所包含的PHP版本，便于用户根据项目需求选择适配的运行环境。

核心功能与特性

• Laravel测试支持：内置运行Laravel测试所需的基础环境与依赖，可直接执行项目测试命令
• 多PHP版本适配：通过镜像标签指定PHP版本（如7.3.0对应PHP 7.3），满足不同项目的PHP版本需求
• CI环境优化：针对自动化测试场景设计，可无缝集成到GitHub Actions、GitLab CI等主流CI平台
• 轻量高效：精简容器体积，专注于测试运行核心功能，提升CI流程执行效率

使用场景

• GitHub Actions工作流：在代码推送或Pull Request触发时，自动化运行Laravel单元测试、功能测试等
• 多环境测试验证：通过切换不同PHP版本标签，验证项目在多版本PHP环境下的兼容性
• 本地测试辅助：本地开发时快速启动标准化测试环境，避免环境差异导致的测试结果不一致
• 其他CI平台集成：适配Jenkins、Bitbucket Pipelines等CI工具，构建统一的测试执行环境

使用方法与配置说明

镜像拉取

根据项目所需PHP版本，通过标签拉取对应镜像：

bash
docker pull kirschbaumdevelopment/laravel-test-runner:<php-version>
# 示例：拉取PHP 7.3版本
docker pull kirschbaumdevelopment/laravel-test-runner:7.3.0

基本测试运行

挂载Laravel项目目录至容器内，并执行测试命令（以PHPUnit为例）：

bash
# 假设当前目录为Laravel项目根目录
docker run -v $(pwd):/app kirschbaumdevelopment/laravel-test-runner:7.3.0 php artisan test

GitHub Actions集成示例

在项目.github/workflows目录下创建测试工作流文件（如tests.yml）：

yaml
name: Laravel Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Run Laravel tests with PHP 8.2
        uses: docker://kirschbaumdevelopment/laravel-test-runner:8.2.0
        with:
          args: |
            composer install --no-interaction
            php artisan test

版本选择说明

镜像标签格式为<php-major.minor.patch>，例如：

• kirschbaumdevelopment/laravel-test-runner:7.4.32：PHP 7.4.32版本
• kirschbaumdevelopment/laravel-test-runner:8.1.20：PHP 8.1.20版本 建议根据项目composer.json中require.php指定的版本范围选择匹配标签

注意事项

• 运行测试前需确保项目依赖已安装，可在测试命令前添加composer install（如上述GitHub Actions示例）
• 若测试需访问数据库等外部服务，需通过--link或网络配置连接对应服务容器
• 敏感配置（如环境变量）可通过-e参数传入容器，确保测试环境配置正确