thinkphp6.0插件生效需完成扩展安装、配置声明、目录规范、钩子绑定四步闭环：安装zzstudio/think-addons扩展，配置addonsserviceprovider与addons参数，创建同级addons目录及规范命名的plugin.php，最后通过hooks.php自动绑定或命令行启用插件。
要在ThinkPHP6.0中让插件真正生效并可被自动加载、路由识别、服务注册，必须完成扩展安装、配置声明、目录规范、钩子绑定四步闭环——漏掉任一环节都会导致插件静默失效，比如addons目录存在但钩子不触发，或插件类能实例化但无法响应事件。
安装插件扩展包
进入项目根目录（含composer.json），执行命令安装通用插件管理器：
composer require zzstudio/think-addons
安装完成后立即验证：运行composer show zzstudio/think-addons，有版本号输出即表示扩展已载入；若无输出，说明当前PHP CLI环境未启用该Composer仓库缓存，需执行composer clear-cache后重试。
这一步操作起来很简单，直接把命令复制粘贴进终端回车就行。但【必须确认框架为TP6.x】：运行composer show topthink/think，确保显示6.x版本（如6.3.5），若显示8.x或3.2.x，该插件将完全无法加载。
启用自动钩子加载并配置基础参数
打开config/app.php，在providers数组末尾添加服务提供者：
'zzstudio\think\AddonsServiceProvider::class',
在同文件中新增addons配置项（可直接追加在providers下方）：
'addons' => [
'autoload' => true,
'hooks' => [],
'route' => [],
'service' => [],
],
autoload设为true后，框架启动时会自动扫描addons/目录下所有插件的hooks.php配置文件并注册对应钩子；若设为false，则必须手动在hooks数组中逐条声明，例如'login_end' => 'captcha'，否则插件钩子永远不会被触发。
创建插件目录结构与核心类
第一步：在项目根目录下新建addons文件夹（注意不是app/addons，是和app同级的addons）；
第二步：在addons内新建插件子目录，名称全部小写、不含空格和符号（如test✅，Test❌，captcha-v1❌）；
第三步：在test目录中创建Plugin.php，首字母必须大写，内容如下：
namespace addons\test;
use think\Addons;
class Plugin extends Addons
{
public $info = [
'name' => 'test',
'title' => '插件测试',
'description' => 'thinkphp6插件测试',
'status' => 0,
'author' => 'byron sampson',
'version' => '0.1'
];
public function install()
{
return true;
}
public function uninstall()
{
return true;
}
}
命名空间必须严格为addons\插件名（如addons\test），不能写成app\addons\test或addons/test；类名必须为Plugin且继承think\Addons，否则框架无法识别该插件为合法扩展。
绑定钩子并验证执行
方法一：自动钩子绑定（推荐）
在test目录下新建hooks.php，内容为：
return [
'app_init' => 'test'
];
该配置表示在应用初始化阶段触发test插件的handleAppInit方法（方法名由钩子名自动映射，无需手动定义）。
方法二：手动钩子调用
在控制器中使用：
use think\Hook;
Hook::listen('testhook');
执行php think addon:install test启用插件；若返回“Install success”，说明插件已激活；此时访问任意页面，只要触发了app_init钩子，test插件中的handleAppInit方法就会被执行——【若无任何反应，请检查plugins目录是否在项目根目录、Plugin.php类是否可被自动加载（执行php -m | grep opcache，关闭opcache可避免类缓存干扰）】。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
