ThinkPHP内容管理系统搭建-ThinkPHP-PHP中文网

thinkphp本身不是cms，而是php开发框架；所谓“搭建cms”是用其快速构建含用户、权限、内容、菜单管理的后台系统，核心在于模块边界清晰、权限校验落于中间件、内容字段支持动态扩展。

thinkphp内容管理系统搭建

直接上结论：ThinkPHP本身不是CMS，它只是框架；所谓“搭建CMS”，本质是用ThinkPHP快速实现一套带用户、权限、内容、菜单管理的后台系统——核心不在于选哪个模板，而在于模块边界是否清晰、权限校验是否落在中间件、内容字段是否支持动态扩展。

ThinkPHP版本与环境必须对齐

TP6.0要求PHP 7.2.5+，TP8.0已强制要求PHP 8.0+；FastAdmin等二开方案则锁死在TP5.1.x。混用会直接报Class "think\Model" not found或Attribute "readonly" is not supported这类错误。

查当前PHP版本：php -v，别信集成环境界面上写的“PHP 8.0”——实际可能还是7.4
装TP6项目时用：composer create-project topthink/think tp-cms，不要加--prefer-dist（避免缓存旧包）
数据库驱动必须启用：pdo_mysql、mbstring、fileinfo，缺一个就卡在Db::connect()初始化阶段

admin模块不能靠手建目录

手动在app/下建admin文件夹再写控制器，会导致路由无法自动识别、模板路径错乱、中间件注册失败。TP6起官方推荐用命令行生成：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

执行：php think module admin，自动生成app/admin结构、基础控制器和路由配置
关键点：生成后要检查route/app.php里是否有Route::import('admin.php', 'admin')这行，没有就手动补上
登录页模板默认走app/admin/view/login/index.html，但View::fetch()默认搜索路径是view/而非view/admin/，需在控制器里显式指定：return View::fetch('admin@login/index')

RBAC权限控制最容易漏掉三处

很多教程只教建auth_rule、auth_group表，但上线后发现“明明分配了权限，菜单就是不显示”，问题常出在以下环节：

中间件中判断登录态用了session('admin_user')，但登录成功后存的是session('admin', $user)，键名不一致导致始终跳转回登录页
AuthRule模型里没重写getRuleList()方法，没把status=1和type=1（菜单项）过滤出来，结果菜单栏空着
前端JS渲染菜单时，把rule_name当成了URL，实际应拼接为/admin/ + rule_name，比如rule_name="user/index" → 最终地址是/admin/user/index

内容模型扩展别硬改`fa_cms_archives`

FastAdmin类方案默认用fa_cms_archives存文章，但企业需求常要加“产品型号”“供应商ID”“审核状态”等字段。直接ALTER TABLE加字段会破坏原有CMS组件逻辑。

正确做法：新建独立模型表，如fa_product，用belongsTo关联到category_id，而非塞进主表
后台列表页若需同时查分类名，别在控制器里循环查CategoryModel::get($id)，改用with('category')预加载
如果必须复用CMS的内容编辑器，把新字段定义在extra字段里（JSON格式），但注意MySQL要设json类型并开启严格模式，否则json_encode()后入库会变空字符串

最常被忽略的其实是请求上下文隔离：后台接口和前台页面共用同一套Request实例，一旦在后台控制器里调了$request->only(['id'])，再进前台逻辑就拿不到原始参数。该用$request->param()的地方绝不能偷懒写input()，否则伪静态规则一开，/article/123里的123就丢了。