cappuc/gitlab-ci-laravel

Laravel测试专用PHP镜像

镜像概述

该镜像为Laravel应用的测试场景提供专用PHP环境，集成了测试过程中常用的工具链，无需手动配置测试依赖，可直接用于Laravel应用的单元测试、集成测试等各类测试任务，简化测试环境搭建流程。

核心功能和特性

• 预配置PHP环境：基于稳定PHP版本（如PHP 8.1/8.2），满足Laravel最新版本的运行需求，包含必要扩展（如mbstring、pdo、json等）。
• Composer依赖管理：内置Composer工具，支持快速安装Laravel项目依赖及测试相关包。
• PHPUnit测试框架：预安装PHPUnit，适配Laravel测试组件，可直接运行php artisan test命令执行测试用例。
• Laravel测试辅助工具：集成Laravel测试所需的辅助库（如laravel/framework测试组件、orchestra/testbench等），简化测试用例编写。
• 代码质量工具：可选集成PHPStan（静态代码分析）、PHPCS（代码规范检查）等工具，支持测试过程中的代码质量验证。

使用场景和适用范围

• 本地开发测试：开发者在本地环境中对Laravel应用进行单元测试、功能测试，验证代码逻辑。
• CI/CD流程集成：作为持续集成/持续部署（CI/CD）流程的测试环境，自动运行测试用例，确保代码提交质量。
• 团队协作场景：统一团队成员的测试环境，避免因本地环境差异导致的测试结果不一致问题。

使用方法和配置说明

基本使用（docker run）

通过以下命令快速启动容器并执行测试：

bash
# 拉取镜像（假设镜像名为laravel-test-php）
docker pull laravel-test-php

# 挂载项目目录并运行测试命令
docker run --rm \
  -v $(pwd):/app \          # 挂载本地Laravel项目目录到容器/app
  -w /app \                 # 设置工作目录为/app
  laravel-test-php \        # 镜像名称
  php artisan test          # 执行Laravel测试命令

Docker Compose配置示例

创建docker-compose.test.yml文件，定义测试服务：

yaml
version: '3.8'

services:
  test:
    image: laravel-test-php
    volumes:
      - ./:/app                # 挂载项目代码
      - vendor_cache:/app/vendor  # 缓存依赖，加速后续测试
    working_dir: /app
    command: php artisan test  # 默认执行测试命令
    environment:
      - APP_ENV=testing        # 设置Laravel环境为测试环境
      - DB_CONNECTION=sqlite   # 测试数据库连接（示例为SQLite）
      - DB_DATABASE=/app/database/testing.sqlite  # SQLite数据库路径

volumes:
  vendor_cache:  # 持久化依赖缓存卷

启动测试服务：

bash
docker-compose -f docker-compose.test.yml up test

环境变量配置

可通过环境变量自定义容器配置：

数据卷挂载说明

• 项目代码挂载：通过-v $(pwd):/app将本地Laravel项目挂载到容器，确保容器可访问最新代码。
• 依赖缓存挂载：通过-v vendor_cache:/app/vendor挂载依赖缓存卷，避免每次运行重新安装Composer依赖，提升测试效率。
• 测试数据挂载：如需持久化测试生成的数据（如日志、测试报告），可额外挂载对应目录（如-v $(pwd)/tests/reports:/app/tests/reports）。