ThinkPHP6.x 持续集成:GitHub Actions自动部署ThinkPHP项目流程

千瑶同学_1982

千瑶同学_1982

2026-06-02

854人浏览

原创

thinkphp6.x项目可通过github actions实现推送即部署:一、ssh直连执行composer install与服务重启;二、rsync预构建后增量同步降低服务器负载;三、封装服务器端shell脚本统一管理多环境部署与回滚。

thinkphp6.x 持续集成:github actions自动部署thinkphp项目流程

如果您已开发完成一个ThinkPHP6.x项目,希望在代码推送后自动完成服务器部署,则需借助GitHub Actions构建CI/CD流水线。以下是实现该目标的多种可行流程:

一、基于SSH直连与Shell脚本的部署流程

该方法通过GitHub Actions运行环境拉取代码、安装依赖,并使用SSH密钥安全连接目标服务器执行部署命令,适用于已配置好PHP、Composer及Web服务(如Nginx)的Linux服务器。

1、在项目根目录创建 .github/workflows/deploy.yml 文件。

2、在服务器上确认已安装 git、php、composer 并能正常执行 php -v 与 composer --version。

3、生成并配置SSH密钥对:在服务器执行 ssh-keygen -t rsa -f ~/.ssh/thinkphp_deploy,将公钥内容追加至 ~/.ssh/authorized_keys,私钥内容复制备用。

4、在GitHub仓库 Settings → Secrets and variables → Actions 中,新增以下密钥:SSH_PRIVATE_KEY(粘贴私钥全文)、SERVER_HOST(服务器IP)、SERVER_USER(登录用户名)、DEPLOY_PATH(如 /var/www/thinkphp6)。

5、在 deploy.yml 中定义工作流,使用 appleboy/scp-action 或 appleboy/ssh-action 执行远程命令,例如拉取代码、运行 composer install --no-dev --optimize-autoloader、设置目录权限、重启PHP-FPM服务等。

二、使用rsync同步静态资源与依赖的轻量部署流程

该流程避免在服务器端重复执行composer install,而是将vendor目录及runtime缓存目录在Actions中预先构建完毕,再通过rsync增量同步至服务器,降低服务器负载并提升部署稳定性。

1、在 deploy.yml 的 jobs 步骤中,先使用 shivammathur/setup-php 安装指定PHP版本(如8.1),再执行 composer install --no-dev --optimize-autoloader。

Linux installer
Linux installer

先解析安全源,运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

2、确保 runtime/ 目录未被.gitignore排除,或在Actions中手动创建空 runtime 目录并赋予写入权限。

3、使用 webfactory/ssh-agent 加载SSH私钥,再调用 rsync 命令同步整个项目目录(排除 .git、.github 等非必要文件)至服务器目标路径。

4、在rsync之后追加SSH命令,执行 chown -R www-data:www-data /var/www/thinkphp6 及 chmod -R 755 /var/www/thinkphp6/runtime,确保Web服务可读写运行时目录。

三、结合部署专用Shell脚本的可复用流程

该方式将部署逻辑封装为服务器端独立脚本,GitHub Actions仅负责触发执行,便于统一管理多环境部署行为、日志记录与错误回滚,适合中大型团队维护。

1、在服务器部署目录(如 /opt/scripts/deploy-thinkphp6.sh)编写bash脚本,包含代码拉取、依赖检查、环境配置加载、缓存清理、配置优化(php think optimize)等步骤。

2、为脚本添加执行权限:chmod +x /opt/scripts/deploy-thinkphp6.sh。

3、在 deploy.yml 中,通过 appleboy/ssh-action 连接服务器后直接运行该脚本:sh /opt/scripts/deploy-thinkphp6.sh。

4、脚本内需校验 .env 文件是否存在,若缺失则从 .env.example 复制并提示人工配置,防止因环境变量缺失导致应用启动失败。

5、脚本末尾加入 systemctl reload php8.1-fpm 或 nginx -s reload 指令,确保配置变更即时生效。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

10204

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6021

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2095

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3788

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4494

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3511

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5017

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3922

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11882

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程