答案：通过配置GitHub Actions工作流文件，实现Laravel项目在代码推送后自动测试并部署至服务器。首先确保服务器环境完备且SSH连接安全，随后在GitHub Secrets中配置所需密钥，包括SSH信息和.env变量；接着创建deploy.yml工作流文件，定义触发条件、运行环境及部署步骤，涵盖代码检出、依赖安装、环境配置、迁移与构建，并通过SSH插件执行远程部署命令；最后可优化为符号链接部署结构以支持零停机发布，整体流程自动化高效，适用于中小型项目快速上线。
要使用 GitHub Actions 为 Laravel 项目实现 CI/CD 自动化部署，核心是通过配置工作流文件（workflow）在代码推送或合并时自动运行测试、构建并部署到服务器。整个流程无需第三方工具，直接集成在 GitHub 中，适合中小型 Laravel 项目快速上线。
1. 准备服务器与项目环境
确保目标服务器已安装 PHP、Composer、MySQL、Nginx 或 Apache 等 Laravel 所需的基础环境。同时配置好 SSH 访问权限，推荐使用部署密钥或 SSH 密钥对实现安全连接。
在服务器上创建项目目录，例如：/var/www/example.com，并设置正确的文件权限（如 www-data 用户可读写 storage 和 bootstrap/cache）。
2. 配置 GitHub Secrets
进入 GitHub 项目的 Settings > Secrets and variables > Actions 页面，添加以下密钥：
- SSH_HOST：服务器 IP 或域名
- SSH_USER：登录用户名（如 ubuntu、root）
- SSH_KEY：私钥内容（从本地生成的 id_rsa 部署密钥粘贴）
- SSH_PORT：SSH 端口（默认 22）
- DB_PASSWORD：数据库密码（用于 .env）
- APP_KEY：Laravel 应用密钥（可从本地 .env 复制）
3. 创建 GitHub Actions 工作流文件
在项目根目录创建 .github/workflows/deploy.yml 文件：
name: Deploy Laravel App
on: push: branches: [ main ] # 触发分支，如 main 或 master
jobs: deploy: runs-on: ubuntu-latest steps:
name: Checkout code uses: actions/checkout@v4
name: Setup PHP uses: shivammathur/setup-php@v2 with: php-version: '8.1' extensions: mbstring, dom, curl, pdo, mysql tools: composer:v2
name: Install dependencies run: composer install --no-interaction --optimize-autoloader --no-dev
name: Copy environment file run: cp .env.example .env
name: Generate application key run: php artisan key:generate env: APP_KEY: ${{ secrets.APP_KEY }}
name: Run migrations run: php artisan migrate --force env: DB_DATABASE: your_db_name DB_USERNAME: your_db_user DB_PASSWORD: ${{ secrets.DB_PASSWORD }}
name: Build assets (if using Laravel Mix) run: npm ci && npm run build
name: Deploy via SSH uses: appleboy/ssh-action@v0.1.10 with: host: ${{ secrets.SSH_HOST }} username: ${{ secrets.SSH_USER }} key: ${{ secrets.SSH_KEY }} port: ${{ secrets.SSH_PORT }} script: | cd /var/www/example.com git pull origin main composer install --optimize-autoloader --no-dev php artisan config:cache php artisan route:cache php artisan view:cache sudo systemctl reload nginx
4. 调整部署策略与优化
上述流程适用于简单场景。若追求零停机，可引入“符号链接部署”结构（类似 Laravel Forge 的方式）：
- 每次部署到新目录（如 releases/20250405001）
- 更新 symbolic link（如 current -> latest release）
- 配合 supervisor、queue worker 重启等命令
也可将部署脚本抽离为 shell 脚本放在服务器上，GitHub Actions 只负责触发执行，减少 workflow 复杂度。
基本上就这些。只要密钥配置正确，服务器环境就绪，推送代码后 GitHub Actions 就会自动完成测试和部署。不复杂但容易忽略细节，比如 .env 权限、SSH 登录限制、composer 扩展缺失等。
