必须掌握中间件绑定时机和模块目录注册路径两个关键点：路由级中间件需在route/app.php中显式绑定别名并确保app/middleware.php已注册；模块须按约定路径（如app/payment/controller/等）组织，且需在app/payment/route/payment.php中定义路由；中间件执行顺序由app/middleware.php数组索引决定；行为标签在app/tags.php注册；服务提供者在app/provider.php声明并继承think\service。
想让ThinkPHP项目在不改核心代码的前提下，灵活插入权限校验、日志记录或接口加密逻辑，同时把新功能模块独立封装、可插拔复用？必须掌握中间件绑定时机和模块目录注册路径这两个关键控制点。
路由级中间件必须显式绑定，不能靠自动识别
第一步：打开 route/app.php，找到你要保护的路由定义行。
第二步：在路由链末尾追加 ->middleware('check_auth')，注意引号内是中间件别名，不是类名。
第三步：确认该别名已在 app/middleware.php 中注册，例如：return [\app\middleware\AuthCheck::class]; —— 如果只写字符串 'auth' 却没在 middleware.php 里映射，运行时报 【Middleware not found: auth】。
第四步：闭包路由也得同样处理，比如 Route::get('api/test', function () { return 'ok'; })->middleware('check_auth');；漏掉它，权限校验就形同虚设。
模块扩展必须按约定路径组织文件结构
方法一：在 app/ 目录下新建模块文件夹，例如 app/payment/。
方法二：严格按 MVC 分层建子目录：controller/、model/、view/、middleware/，缺一不可。
方法三：在 app/payment/route/ 下新建 payment.php，内容为：
use think\facade\Route;<br>Route::group('pay', function () {<br> Route::get('order', 'payment.controller.Order@index');<br>});
这一步不做，URL 访问路径就无法解析到你的控制器。
中间件执行顺序由 app/middleware.php 数组索引决定
打开 app/middleware.php，看到返回的是一个纯数组：
return [<br> \think\middleware\SessionInit::class,<br> \app\middleware\ForceHttps::class,<br> \think\middleware\LoadLangPack::class<br>];
数组下标越小，请求阶段执行越早；响应阶段则倒序执行。
想让 ForceHttps 中间件最先拦截 HTTP 请求？把它挪到数组第一个位置。
【不要在中间件类里加 $priority 属性】，ThinkPHP 完全不读这个字段。
行为标签扩展必须在 app/tags.php 中注册
创建 app/tags.php 文件，确保它返回一个关联数组：
return [<br> 'app_init' => [<br> \app\behavior\InitConfigBehavior::class<br> ],<br> 'app_end' => [<br> \app\behavior\RecordLogBehavior::class<br> ]<br>];
行为类命名空间必须与文件路径完全一致，例如 app/behavior/InitConfigBehavior.php 的命名空间是
app\behavior。如果行为没触发，先运行
think\Hook::getListeners('app_init') 查看返回值——空数组说明 tags.php 没被加载，检查 CONF_PATH 是否指向正确路径。
服务提供者注册需写入 app/provider.php
第一步：在 app/provider.php 中添加你的服务提供者类名：
return [<br> 'app\provider\PaymentServiceProvider',<br> // 其他已存在的提供者<br>];
第二步：确保该类继承
think\Service 并实现 register() 和 boot() 方法。第三步：在
register() 中绑定服务到容器，例如：$this->app->bind('payment', PaymentService::class);。第四步：调用时直接使用
app('payment') 获取实例，无需 new 关键字。第五步：若服务提供者未生效，检查 app/provider.php 是否被框架自动 require —— 它只在应用启动时加载一次，修改后需清空 runtime/cache/ 目录。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
