通过配置GitHub Actions可实现Laravel项目的自动化测试与部署。首先在项目根目录的.github/workflows/中创建ci-cd.yml文件，定义工作流触发条件为推送或拉取请求至main分支。工作流包含test和deploy两个主要任务：test任务在Ubuntu环境中运行，启动MySQL服务并设置PHP版本为8.1，通过缓存加速Composer依赖安装，复制.env.example文件并生成应用密钥，执行数据库迁移与种子填充，并运行单元测试，所有数据库配置使用环境变量注入；deploy任务依赖test成功执行，且仅在推送到main分支时触发，通过ssh-action使用SSH密钥连接远程服务器，执行git pull、composer安装、配置缓存及Nginx重载等命令完成部署。为保障安全，SSH主机、用户名和私钥均通过GitHub Secrets管理，避免敏感信息泄露。建议启用缓存提升效率，结合phpstan等工具进行静态分析，并区分不同环境的部署策略，也可集成Laravel Forge或Envoy实现更复杂流程。最终实现从代码提交到生产部署的全流程自动化，提高开发效率与系统稳定性。

在现代 Laravel 项目开发中，使用 GitHub Actions 实现自动化测试和部署是一种高效、可靠的方式。通过配置工作流（Workflow），可以在代码推送到仓库时自动运行测试、检查代码质量，并将应用部署到生产或预发布环境。

配置 GitHub Actions 工作流文件

GitHub Actions 的工作流由 YAML 文件定义，存放在项目根目录的 .github/workflows/ 目录中。创建一个名为 ci-cd.yml 的文件，用于定义自动化流程。

以下是一个典型的 Laravel 项目 CI/CD 配置示例：

name: Laravel CI/CD
on:
push:
branches: [ main ]
pull_request:
branches: [ main ]
jobs:
test:
runs-on: ubuntu-latest
services:
  mysql:
    image: mysql:8.0
    env:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: homestead
    ports:
      - 3306:3306
    options: --health-start-period=10s --health-interval=1s --health-timeout=5s --health-retries=30

steps:
  - name: Checkout code
    uses: actions/checkout@v4

  - name: Setup PHP
    uses: shivammathur/setup-php@v2
    with:
      php-version: '8.1'
      extensions: mbstring, dom, pdo, mysql, curl, openssl
      tools: composer:v2

  - name: Cache Composer dependencies
    uses: actions/cache@v3
    with:
      path: vendor
      key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
      restore-keys: ${{ runner.os }}-php-

  - name: Install dependencies
    run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress

  - name: Copy .env
    run: cp .env.example .env

  - name: Generate application key
    run: php artisan key:generate

  - name: Run migrations
    run: php artisan migrate:fresh --seed
    env:
      DB_CONNECTION: mysql
      DB_HOST: 127.0.0.1
      DB_PORT: 3306
      DB_DATABASE: homestead
      DB_USERNAME: root
      DB_PASSWORD: rootpassword

  - name: Run tests
    run: php artisan test
    env:
      DB_CONNECTION: mysql
      DB_HOST: 127.0.0.1
      DB_PORT: 3306
      DB_DATABASE: homestead
      DB_USERNAME: root
      DB_PASSWORD: rootpassword
添加部署任务到服务器
测试通过后，可以配置部署步骤，将代码自动推送到生产或测试服务器。常用方式是通过 SSH 执行远程命令。
在 jobs 下新增 deploy 任务：
  deploy:
    needs: test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
steps:
  - name: Deploy to Server
    uses: appleboy/ssh-action@v0.1.10
    with:
      host: ${{ secrets.SSH_HOST }}
      username: ${{ secrets.SSH_USER }}
      key: ${{ secrets.SSH_PRIVATE_KEY }}
      script: |
        cd /var/www/html/my-laravel-app
        git pull origin main
        composer install --optimize-autoloader --no-dev
        php artisan config:cache
        php artisan route:cache
        php artisan view:cache
        systemctl reload nginx
注意：需要在 GitHub 仓库的 Settings > Secrets and variables > Actions 中设置以下密钥：


SSH_HOST：目标服务器 IP 或域名

SSH_USER：SSH 登录用户名（如 ubuntu、root）

SSH_PRIVATE_KEY：私钥内容（建议使用无密码密钥并限制权限）

优化与安全建议
为了提升自动化流程的效率和安全性，可参考以下建议：

使用缓存加快依赖安装速度，避免每次重复下载 Composer 包
在部署前运行代码静态分析，例如使用 phpstan 或 pint

为不同环境（如 staging、production）设置不同的分支策略和部署条件
避免在脚本中硬编码敏感信息，全部使用 GitHub Secrets 管理
考虑使用 Laravel Forge 或 Envoy 结合 GitHub Actions 实现更复杂的部署逻辑

基本上就这些。通过合理配置 GitHub Actions，Laravel 项目可以实现从提交代码到测试再到部署的全流程自动化，显著提升开发效率和系统稳定性。