首页 > php框架 > Laravel > 正文

Laravel怎么使用Github Actions实现CI/CD自动化部署

尼克
发布: 2025-11-18 18:41:02
原创
731人浏览过
答案:通过配置GitHub Actions工作流文件,实现Laravel项目在代码推送后自动测试并部署至服务器。首先确保服务器环境完备且SSH连接安全,随后在GitHub Secrets中配置所需密钥,包括SSH信息和.env变量;接着创建deploy.yml工作流文件,定义触发条件、运行环境及部署步骤,涵盖代码检出、依赖安装、环境配置、迁移与构建,并通过SSH插件执行远程部署命令;最后可优化为符号链接部署结构以支持零停机发布,整体流程自动化高效,适用于中小型项目快速上线。

laravel怎么使用github actions实现ci/cd自动化部署

要使用 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 文件:

绘ai
绘ai

ai绘图提示词免费分享

绘ai 153
查看详情 绘ai
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 扩展缺失等。

以上就是Laravel怎么使用Github Actions实现CI/CD自动化部署的详细内容,更多请关注php中文网其它相关文章!

Github
Github

Github是一款非常实用的代码开放工具,用户可以按照自己的需求进行搜索,从而快速定位到所需的代码或项目位置,还能在软件中建立自己的代码仓库,有需要的小伙伴快来保存下载体验吧!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号