通过配置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/CDon: 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 项目可以实现从提交代码到测试再到部署的全流程自动化，显著提升开发效率和系统稳定性。
