答案:通过配置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:cache php artisan route:cache php artisan view:cache sudo systemctl reload nginx
上述流程适用于简单场景。若追求零停机,可引入“符号链接部署”结构(类似 Laravel Forge 的方式):
也可将部署脚本抽离为 shell 脚本放在服务器上,GitHub Actions 只负责触发执行,减少 workflow 复杂度。
基本上就这些。只要密钥配置正确,服务器环境就绪,推送代码后 GitHub Actions 就会自动完成测试和部署。不复杂但容易忽略细节,比如 .env 权限、SSH 登录限制、composer 扩展缺失等。
以上就是Laravel怎么使用Github Actions实现CI/CD自动化部署的详细内容,更多请关注php中文网其它相关文章!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号