ThinkPHP企业项目关键在于首日即控边界、管生命周期、防耦合;默认结构仅适用于演示,生产必须物理隔离多应用入口、显式init()初始化、array_merge()继承配置、手动注册路由与服务、权限动态校验、业务逻辑沉入服务层。

ThinkPHP搭企业项目,关键不在“从零写代码”,而在“从第一天就控住边界、管住生命周期、防住耦合”。默认安装结构是演示用的,直接上线等于埋雷——路由混用、缓存冲突、权限硬编码、事务裸奔,都是高频翻车点。真正跑得稳的项目,靠的是结构前置、配置显式、职责分层。
入口与多应用必须物理隔离
admin、api、web不能共用一个index.php。每个应用要有独立入口文件,且必须显式初始化:
- public/admin.php中写
$app = new think\App(); $app->init('admin');,不是$app->run()前随便传个字符串 - init('admin')会自动加载app/admin/下的配置、服务和中间件,漏这步,config/admin/database.php根本不会生效
- api.php同理,不能靠“目录名自动识别”,框架不会猜你想要哪个应用
配置要显式合并,不能靠覆盖
子应用配置不是“只写差异项”,而是完整继承+增量定义:
- config/api/database.php必须用
array_merge(include '../config/database.php', [...]),否则default连接丢失,Db::connect('default')直接报错 - 所有env()变量(如
env('APP_NAME'))在配置加载时已解析,可放心用于缓存前缀、日志路径等动态值 - Redis缓存前缀必须绑定应用名:
'prefix' => env('APP_NAME', 'default'),否则admin和api共用cache:menu导致数据互相污染
路由和服务注册要手动接管
ThinkPHP 8的multi-app不自动加载子应用路由和Service:
立即学习“PHP免费学习笔记(深入)”;
- route/api.php不会被自动识别,必须在app/api/RouteService.php中重写
register()方法,显式调用Route::import('api') - 中间件、事件监听器、自定义服务也需在对应应用的ServiceProvider里手动注册,不能指望全局自动扫描
- 权限控制别用静态RBAC表硬编码,应在中间件里解析请求上下文(如order_id、IP、当前时间),再查auth_rules表的condition字段(存PHP表达式),运行时白名单校验后执行
业务逻辑必须沉到服务层
控制器只做协议转换,不碰DB、不写事务、不发消息:
- OrderController::create()只校验参数格式,然后调
OrderService::place($data) - OrderService里才封装完整用例:用
Db::transaction()包住库存扣减、订单生成、消息投递,事务边界清晰 - 模型只负责数据映射和关联定义,不放业务规则;验证器管输入校验,不掺杂领域逻辑
不复杂但容易忽略



















