
TSCMS 是腾石科技基于 ThinkPHP 框架开发的企业级内容管理系统,适用于企业建站、内容门户和内部管理系统等场景。近期 Gitee 上的 tscms2.x 仓库正式上线 2.0 版本:它在 1.x(ThinkPHP 5.1)基础上完整重构到 ThinkPHP 8 与 PHP 8,业务功能和数据结构与 1.x 保持一脉相承,老站点可以按补丁平滑升级。本文对照 sootou/tscms(1.x)与 sootou/tscms2.x(2.x)两个仓库,梳理这次升级的主要变化、模块扩充和迁移要点。
一、底层框架:从 ThinkPHP 5.1 / PHP 7 升级到 ThinkPHP 8 / PHP 8
1.x 版本底层采用 ThinkPHP 5.1 LTS,运行环境为 PHP 7.0 以上(推荐 7.0~7.4),数据库要求 MySQL 5.5 以上,框架系统目录随源码一起分发。2.x 则直接迁移到 ThinkPHP 8.0,要求 PHP 8.0 以上(推荐 8.2),数据库支持 MySQL 5.7+ 或 MariaDB 10.3+,ORM 使用 think-orm 3.x/4.x,第三方依赖统一交由 Composer 管理,vendor 目录不再纳入版本库。
这一变化的意义在于:PHP 7 已陆续停止官方安全维护,继续运行在 5.1 框架上的老站点会长期暴露在兼容与安全风险中。升级到 ThinkPHP 8 + PHP 8 后,站点能够跟进框架的安全更新、性能优化和新语法特性(类型声明、命名参数等),后台与前台代码也更容易接入现代开发工具链。需要注意的是,2.x 的数据库表前缀由 1.x 的 ts_ 调整为 tc_,老库升级时由结构补丁统一对齐。
二、目录结构与部署方式重构
1.x 的应用代码位于 application/ 目录,框架核心放在仓库内的 thinkphp/ 目录,入口文件 index.php、install.php 放在站点根目录,既支持根目录部署,也支持 public 子目录部署。2.x 改为标准的多应用结构:应用代码统一放在 app/ 下,后台 admin、内容 content、会员 member、接口 api、前台 home、安装 install 各自独立,共享 common 公共层;配置集中在 config/(app、database、view、cache、session、version 等),路由独立到 route/,扩展类库放在 extend/,备份文件位于 data/backup。
部署上,2.x 要求把 Web 运行目录指向 public/,前台、后台、安装入口分别对应 index.php、admin.php、install.php。依赖必须先执行 composer install 安装,否则入口文件加载不到 vendor/autoload.php,包括安装页在内的所有页面会直接白屏 500。相比 1.x,这套结构更符合 ThinkPHP 官方规范,二次开发和团队协作时的目录认知成本更低。
三、后台体验与安全体系增强
两版后台界面都基于 Layui,但 2.x 升级为 iframe 多标签页模式,后台切换菜单时不必反复刷新整页,多内容并行处理更顺手。登录认证方面,1.x 使用 Session 双重签名校验;2.x 在 Session 登录基础上增加加密因子双重校验,密码以 md5(md5(pwd)+encrypt) 方式参与校验,密码哈希不与固定盐值直接对应,安全性更强。
权限系统延续基于后台菜单节点的 RBAC 模型,2.x 对应 tc_menu、tc_auth_rule、tc_auth_group 三张表,支持角色分组和菜单级细粒度授权。内容侧,富文本仍使用 UEditor,2.x 明确支持图片上传和远程图片本地化;附件管理统一处理缩略图生成与图片水印,敏感词在发布时自动检测,后台所有增删改操作都写入操作日志,便于审计和回溯。
四、可插拔模块大幅扩充
TSCMS 一直采用模块可插拔架构,功能模块独立安装、卸载。对比两个仓库可以看到,基础模块在两版中都有保留:友情链接、幻灯片(1.x 称轮播图)、广告管理、自定义表单、支付模块(微信支付、支付宝)、短信模块(阿里云、腾讯云等)、采集模块。
2.x 的扩充主要集中在两块。一是小程序模块:1.x 仅支持微信小程序接口;2.x 覆盖微信、支付宝、抖音、百度、QQ、快手等多个平台,支持登录、手机号授权和小程序收录提交,一套后台对接多端。二是新增面向运营场景的模块:AI 自动发文(接入大模型自动生成并发布内容)、GEO 排名(生成式引擎优化,包含 AI 收录检测与自媒体文章分发)、Bug 反馈收集,以及会员中心的 OAuth 第三方登录。会员体系本身延续注册登录、积分余额、收藏投稿、充值管理等能力。
五、内容管理能力一脉相承
对日常建站最核心的内容功能,2.x 并没有推倒重来。栏目管理支持无限级分类,提供单页面、文章列表、外部链接三种栏目类型;内置单页、文章、图片三种内容模型,支持自定义模型和扩展字段;内容侧支持缩略图、多图、附件、标签、推荐位、置顶/头条/幻灯,以及稿件审核退稿、回收站还原、全站或指定表批量替换。
前台调用方式也保持延续,仍通过自定义标签库 {ts module="content" action="lists"} 这类标签调取数据;URL 规则在后台可视化配置,支持 {catdir}/{id}、{parentdir}/{catdir} 等变量生成 SEO 友好链接;多模板风格切换无需改动代码,栏目和内容支持静态化,可自动生成 XML Sitemap。内链管理、IP 黑名单、数据库备份还原、钩子管理等扩展功能在 2.x 中同样保留。
六、从 1.x 升级到 2.x 的操作步骤
官方 README 给出的升级路径分为四步:第一,先完整备份数据库和 public/upload 附件目录;第二,覆盖程序文件,注意保留 .env、config/database.php 和上传目录;第三,在旧库执行 db_patch_mythink2.sql,把表结构和字段类型对齐到 2.0,该补丁只调整结构、不迁移业务数据,执行前务必先做 mysqldump 备份;第四,清理 runtime/ 运行时缓存后访问后台,再到模块管理中按需安装扩展模块。
升级前还需要先确认服务器环境:PHP 升到 8.0 以上,安装 Composer 2.x,开启 PDO、pdo_mysql、GD、mbstring、OpenSSL、CURL、JSON、Fileinfo、ZIP 等扩展,站点运行目录指向 public/,并按 Apache 或 Nginx 配置好伪静态规则。
七、总结
TSCMS 2.x 不是一次小版本修补,而是框架底层、运行环境和工程规范的全面重构:ThinkPHP 5.1 升级到 ThinkPHP 8,PHP 7 迁移到 PHP 8,目录结构向官方多应用规范对齐,后台安全校验和模块生态同步增强。与此同时,栏目、模型、标签、模板、权限等业务概念与 1.x 保持延续,老站点可以借助结构补丁平滑过渡。无论是正在选型 ThinkPHP 系 CMS 的新项目,还是 1.x 站点计划跟进 PHP 8 生态,都可以对照两个仓库评估这次升级。

















文章点评