PHP插件化架构核心是保障主系统稳定，需用观察者模式解耦事件通知、DI容器安全替换服务；必须校验插件接口与方法、规范自动加载、禁止构造函数耗时操作，并显式定义插件依赖顺序。
PHP插件化架构的核心不是“能不能加功能”，而是“加了之后会不会让主系统崩溃”。观察者模式和DI容器不是炫技工具，它们分别解决两个硬问题：**事件通知的解耦**和**服务依赖的安全替换**。用错地方或漏掉关键约束，插件一多，Class 'Plugins\Xxx' not found 或 Cannot resolve dependency 就会高频出现。
为什么必须用观察者模式实现钩子，而不是简单回调数组
直接用 array_map() 遍历回调函数看似省事，但无法处理数据流转、中断传播和优先级控制。观察者模式强制定义 Event 对象作为数据载体，让每个监听器有机会修改、终止或跳过后续执行。
- 必须封装事件对象：不能传原始数组或字符串，例如
new UserLoginEvent($userId)，而非do_action('user.login', $userId) - 监听器必须返回
Event实例（或null表示不干预），否则链式处理断裂 - 注册时需支持优先级参数：
$dispatcher->addListener(UserLoginEvent::class, [$plugin, 'onLogin'], 10)，默认 0，数值越小越先执行 - 避免在事件中抛出未捕获异常——一个插件崩了，不能拖垮整个登录流程；应在
dispatch()内统一 try/catch 并记录日志
DI容器不是“把类塞进去就完事”，关键在作用域与覆盖策略
插件需要共享数据库连接、缓存实例等资源，但又不能允许某个插件偷偷替换成自己的 PDO 实例导致其他插件读写错库。DI 容器必须区分“共享服务”和“插件私有服务”。
- 核心服务（如
database、logger）注册为shared，且禁止插件调用extend()或protect()修改其定义 - 插件自定义服务（如
myplugin.api_client）必须显式声明作用域：$container->add('myplugin.api_client', function ($c) { return new ApiClient($c->get('http_client')); }) - 插件初始化时只能通过
$container->get()获取服务，严禁 new 实例——否则绕过容器，DI 失效 - 若插件需覆盖某服务行为（如替换日志处理器），应通过事件监听
LoggerInitializedEvent实现，而非直接重绑定
自动加载插件时，class_exists() 不够用，必须校验接口与生命周期方法
扫描 plugins/ 目录后，仅靠 class_exists() 判断类存在，会导致运行时报错：插件类没实现 PluginInterface，或漏了 activate() 方法。
立即学习“PHP免费学习笔记（深入）”；
- 加载前必须检查：
interface_exists(PluginInterface::class)且in_array(PluginInterface::class, class_implements($class)) - 必须验证方法存在：
method_exists($instance, 'activate')和method_exists($instance, 'registerHooks')，缺一则跳过加载并记录警告 - 插件类必须使用完整命名空间，且 PSR-4 自动加载路径需与目录结构严格一致，例如
Plugins\UserAudit\Plugin→plugins/user-audit/src/Plugin.php - 禁止插件在
__construct()中执行耗时操作（如建表、远程请求），所有初始化逻辑移入activate()，由框架统一调度
最易被忽略的一点：插件之间没有天然的执行顺序保证。即使你按字母序加载插件，也不能假设 A 插件的 activate() 一定在 B 之前完成——除非你显式定义依赖关系并在加载阶段做拓扑排序。否则，当插件 B 试图调用插件 A 注册的钩子时，HookManager 里可能还空着。
