答案：通过配置GitHub Actions工作流文件，实现Laravel项目在代码推送后自动测试并部署至服务器。首先确保服务器环境完备且SSH连接安全，随后在GitHub Secrets中配置所需密钥，包括SSH信息和.env变量；接着创建deploy.yml工作流文件，定义触发条件、运行环境及部署步骤，涵盖代码检出、依赖安装、环境配置、迁移与构建，并通过SSH插件执行远程部署命令；最后可优化为符号链接部署结构以支持零停机发布，整体流程自动化高效，适用于中小型项目快速上线。
要使用 GitHub Actions 为 Laravel 项目实现 CI/CD 自动化部署，核心是通过配置工作流文件（workflow）在代码推送或合并时自动运行测试、构建并部署到服务器。整个流程无需第三方工具，直接集成在 GitHub 中，适合中小型 Laravel 项目快速上线。
确保目标服务器已安装 PHP、Composer、MySQL、Nginx 或 Apache 等 Laravel 所需的基础环境。同时配置好 SSH 访问权限，推荐使用部署密钥或 SSH 密钥对实现安全连接。
在服务器上创建项目目录，例如：/var/www/example.com，并设置正确的文件权限（如 www-data 用户可读写 storage 和 bootstrap/cache）。
进入 GitHub 项目的 Settings > Secrets and variables > Actions 页面，添加以下密钥：
在项目根目录创建 .github/workflows/deploy.yml 文件：
name: Deploy Laravel Appon: 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:ca
che
php artisan route:cache
php artisan view:cache
sudo systemctl reload nginx
上述流程适用于简单场景。若追求零停机，可引入“符号链接部署”结构（类似 Laravel Forge 的方式）：
也可将部署脚本抽离为 shell 脚本放在服务器上，GitHub Actions 只负责触发执行，减少 workflow 复杂度。
基本上就这些。只要密钥配置正确，服务器环境就绪，推送代码后 GitHub Actions 就会自动完成测试和部署。不复杂但容易忽略细节，比如 .env 权限、SSH 登录限制、composer 扩展缺失等。
服务热线