企业级ThinkPHP插件架构需支持多团队并行开发、灰度发布、运行时启停与故障隔离；插件须置于addons/目录下，目录名须为小写+下划线的合法PHP标识符，且addon.php中name字段与目录名严格1:1匹配；path值必须用双反斜杠并以反斜杠结尾；路由需在route/app.php中显式绑定，控制器命名空间必须以addons\开头；插件迁移需在插件目录执行php ../../think migrate:run，若有composer.json还需在根目录执行composer dump-autoload -o。
企业级ThinkPHP插件架构必须支撑多团队并行开发、灰度发布、运行时启停与故障隔离，不能靠手动复制粘贴或改配置硬编码实现功能扩展。
插件物理位置与目录命名规范
插件必须放在与app/同级的addons/目录下，例如addons/wechat_login，绝对不可塞进app/内部。
ThinkPHP默认把app/下所有子目录当“应用”处理，一旦插件混入其中，路由扫描失效、自动加载错乱、命令行工具（如php think）直接跳过该目录——它根本不认为那是可独立管理的扩展单元。
插件目录名必须是合法PHP标识符：小写字母+下划线，例如alipay_payment，禁止驼峰（AlipayPayment）或中划线（alipay-payment），否则类自动加载器无法映射命名空间。
立即学习“PHP免费学习笔记（深入）”；
【name字段必须与目录名1:1严格一致，大小写敏感】
addon.php元信息定义与关键校验点
每个插件根目录下必须存在addon.php文件，返回一个关联数组，缺一不可。
示例内容：
return [ 'name' => 'wechat_login', 'title' => '微信登录', 'path' => 'addons\wechat_login\', 'has_admin' => true,];
【path值必须用双反斜杠，末尾带反斜杠】 若写成addons/wechat_login/（正斜杠）或addons\wechat_login（漏反斜杠），类加载器将找不到WechatLoginService等核心类。
框架加载插件时，先按name找目录，再按path定位命名空间根路径——两处不匹配，插件直接被跳过，无任何报错提示，极易踩坑。
插件内控制器注册与路由绑定
TP不会自动扫描插件目录下的controller/子目录。你写了addons/wechat_login/controller/LoginController.php，但没配路由，访问/wechat_login/login就是404。
必须在项目根目录的route/app.php中显式绑定：
Route::group('wechat_login') ->middleware([\app\middleware\AllowCrossDomain::class]) ->append(['index' => 'addons\wechat_login\controller\LoginController@index']) ->pattern(['id' => '\d+']);
注意：控制器完整命名空间必须以addons\开头，不能省略；append方法确保路由规则仅作用于该插件，避免与其他模块冲突。
插件迁移与自动加载刷新
第一步：在插件目录下执行数据库迁移命令cd addons/wechat_login && php ../../think migrate:run
第二步：若插件自带composer.json（含自定义类或依赖），必须回到项目根目录执行：composer dump-autoload -o
这一步不可跳过。未执行会导致新定义的模型、服务类无法被自动加载，运行时报Class not found错误，且错误堆栈不指向插件目录，排查成本极高。
