chilio/laravel-dusk-ci

Laravel Dusk GitLab CI/CD 浏览器测试环境

镜像概述

这是一个完整的测试套件，用于在Laravel项目中运行测试（单元测试、功能测试、浏览器测试）。它通过GitLab的Docker执行器，使用Laravel Dusk进行浏览器测试。该镜像自动处理Chrome和chromedriver的兼容性问题，使Laravel Dusk浏览器测试尽可能简单。

版本信息

支持的版本

已弃用的版本

说明：保留弃用版本是为了支持旧版Laravel应用在迁移到新版本期间的浏览器测试。所有发布的镜像均功能完整，可用于测试目的。

兼容性

核心功能与特性

包含的组件（版本取决于镜像标签）

查看版本：在.gitlab-ci.yml的script中运行versions命令，可查看已安装包的具体版本。

可用的附加命令

• configure-laravel：设置文件权限、生成Laravel密钥、迁移并填充数据库、检查并确保chromedriver兼容性。
• start-nginx-ci-project：配置并启动Nginx和PHP-FPM。
• versions：显示包含的包版本和启用的PHP模块。

使用场景

适用于GitLab CI/CD流水线中的Laravel项目测试，特别是需要运行浏览器测试的场景。支持自动化单元测试、功能测试和端到端浏览器测试，确保代码质量和功能稳定性。

使用方法与配置说明

前置要求

必须修改项目中的tests/DuskTestCase.php，添加--no-sandbox参数到驱动选项中，否则镜像无法正常工作。参考https://github.com/chilio/laravel-dusk-ci/blob/master/examples/DuskTestCase.php%E3%80%82

GitLab CI/CD配置示例

在项目的.gitlab-ci.yml中使用以下配置：

yaml
image: chilio/laravel-dusk-ci:latest

services:
  - mysql:5.7  # 或其他兼容版本，mysql:latest需特殊配置（见下方数据库说明）

variables:
  MYSQL_ROOT_PASSWORD: root
  MYSQL_DATABASE: test_db
  MYSQL_USER: test_user
  MYSQL_PASSWORD: test_password
  DB_HOST: mysql
  APP_URL: http://localhost

test:
  script:
    - cp .env.example .env
    - configure-laravel
    - start-nginx-ci-project
    - php artisan dusk

数据库配置

MySQL设置

• 添加MySQL服务到services：

  yaml
  services:
    - name: mysql:latest
      command: ["--default-authentication-plugin=mysql_native_password"]  # mysql:latest需添加此命令
  

• 在config/database.php中添加MySQL模式配置：

  php
  'mysql' => [
      // ...其他配置
      'modes' => [
          'ONLY_FULL_GROUP_BY',
          'STRICT_TRANS_TABLES',
          'NO_ZERO_IN_DATE',
          'NO_ZERO_DATE',
          'ERROR_FOR_DIVISION_BY_ZERO',
          'NO_ENGINE_SUBSTITUTION',
      ],
  ],
  

高级配置

自定义测试环境

• 复制CI专用配置文件：

  yaml
  script:
    - cp phpunit.xml.ci phpunit.xml  # 使用CI专用PHPUnit配置
    - cp phpunit.dusk.xml.ci phpunit.dusk.xml  # 使用CI专用Dusk配置
  

前端资源构建

如需构建前端资源，添加以下命令：

yaml
script:
  - npm install
  - npm run dev  # 或 yarn run dev

运行PHPUnit测试

yaml
script:
  - ./vendor/phpunit/phpunit/phpunit -v --coverage-text --colors --stderr

Chromedriver兼容性处理

若遇到chromedriver版本问题，可选择以下方案：

1. 使用系统内置chromedriver：
   • 在DuskTestCase.php中注释掉static::startChromeDriver();
   • 在.gitlab-ci.yml中添加：

     yaml
     script:
       - chromedriver &  # 启动系统内置chromedriver
       - php artisan dusk
     

示例文件

• https://github.com/chilio/laravel-dusk-ci/blob/master/examples/DuskTestCase.php%EF%BC%9A%E5%8C%85%E5%90%AB%E8%BF%90%E8%A1%8C%60php artisan dusk`所需的所有修改
• https://github.com/chilio/laravel-dusk-ci/blob/master/examples/phpunit.dusk.xml%EF%BC%9ADusk%E6%B5%8B%E8%AF%95%E4%B8%93%E7%94%A8PHPUnit%E9%85%8D%E7%BD%AE
• https://github.com/chilio/laravel-dusk-ci/blob/master/examples/phpunit.xml.ci%EF%BC%9ACI%E7%8E%AF%E5%A2%83PHPUnit%E9%85%8D%E7%BD%AE
• https://github.com/chilio/laravel-dusk-ci/blob/master/examples/.gitlab-ci.yml%EF%BC%9A%E5%8C%85%E5%90%AB%E9%98%B6%E6%AE%B5%E3%80%81%E7%BC%93%E5%AD%98%E5%92%8C%E5%88%B6%E5%93%81%E9%85%8D%E7%BD%AE%E7%9A%84%E5%AE%8C%E6%95%B4CI%E7%A4%BA%E4%BE%8B

故障排除

• 测试失败：尝试按以下顺序使用不同镜像标签：chilio/laravel-dusk-ci:latest → chilio/laravel-dusk-ci:stable → chilio/laravel-dusk-ci:dev
• 页面加载问题：在Dusk测试中使用->waitFor()确保页面渲染完成，CI环境通常比本地环境慢
• 屏幕分辨率：通过环境变量SCREEN_RESOLUTION调整（默认1920x720x24），例如：

  yaml
  variables:
    SCREEN_RESOLUTION: 1280x720x24
  

• MySQL连接错误：检查DB_HOST是否设置为mysql，或尝试更换MySQL版本（如mysql:5.7）
• chromedriver版本错误：参考“Chromedriver兼容性处理”部分，使用系统内置chromedriver

免责声明

本镜像仅用于CI环境中的测试目的，不建议用于生产环境。