laravel怎么使用GitHub Actions实现自动化测试和部署_laravel GitHub Actions自动化测试与部署方法-Laravel-PHP中文网

laravel怎么使用GitHub Actions实现自动化测试和部署_laravel GitHub Actions自动化测试与部署方法

冰火之心

发布： 2025-10-28 14:54:02

原创

506人浏览过

通过配置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实现自动化测试和部署_laravel github actions自动化测试与部署方法

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

配置 GitHub Actions 工作流文件

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

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

name: Laravel CI/CD
<p>on:
push:
branches: [ main ]
pull_request:
branches: [ main ]</p><p>jobs:
test:
runs-on: ubuntu-latest</p><pre class='brush:php;toolbar:false;'>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 任务：

GitHub Copilot

GitHub AI编程工具，实时编程建议

查看详情

  deploy:
    needs: test
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
<pre class='brush:php;toolbar:false;'>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 中设置以下密钥：