原理

HookService 在业务关键点触发钩子,插件通过 hooks.php 中 add_hook() 订阅。

// 业务侧
HookService::trigger('AfterInvoicePaid', ['invoice_id' => 1, ...]);

// 插件 hooks.php
add_hook('after_invoice_paid', function ($param) {
    // 与 AfterInvoicePaid 等价(snake_case 自动映射)
});

注册方式

方式 说明
代码 HookService::add() / add_hook()
数据库 kd_hooks 表(class + method,插件安装时可写入)

启用插件时 PluginService::boot() 自动 include hooks.php。


魔方别名

系统钩子 额外触发名
AfterInvoicePaid order_paid
AfterUserRegister register_after
AfterTicketOpen ticket_create_after
AfterTicketReply ticket_reply_after
AfterModuleCreate module_create_after
AfterHostRenew host_renew_after

常用钩子列表

钩子 触发位置 参数示例
UserLogin 用户登录 user_id
AdminLogin 管理员登录 admin_id
AfterUserRegister 注册成功 user_id
AfterOrderCreate 订单创建 order_id, user_id
AfterInvoicePaid 账单支付 invoice_id, user_id
AfterModuleCreate 自动开通成功 host_id, module
ModuleCreateFailed 开通失败 host_id, error
AfterTicketOpen 工单创建 ticket_id, user_id
AfterTicketReply 工单回复 ticket_id
AfterAddonInstall 插件安装 name
AfterAddonUninstall 插件卸载 name
AfterUpgrade 系统更新 to_build

插件示例

// public/plugins/addon/order_notify/hooks.php
add_hook('order_paid', function ($param) {
    OrderNotify::onPaid($param);
});

优先级:数字越小越先执行(默认 50)。


注意事项

  1. 钩子内避免长时间阻塞;发邮件用 NotifyService::sendMailQuiet()
  2. 抛异常会被 HookService 捕获并写 trace 日志,不中断主流程
  3. 命名推荐 snake_case,与魔方插件保持一致

下一章:12-API 与路由

下载文档
原始 Markdown 文件