钩子跑在请求主链路里
addAction() / addFilter() 注册的回调,会在用户那次请求里同步执行:前台打开一个页面、客户端调一次接口,平台都会按优先级依次调用相关钩子。回调花掉的时间,会直接叠加到用户的等待时间里。
所以:能异步做的(发信、同步到外部系统)尽量交给定时任务;能缓存的不要每次请求都算;绝不要在渲染钩子里查数据库或请求外网。
预算与熔断
平台会给每个回调计时,并对异常做隔离:
- 单个回调耗时超过
PLUGIN_SLOW_HOOK_MS(默认 300 ms):记为一次「慢钩子」,写入插件日志; - 单个回调耗时超过
PLUGIN_HOOK_HARD_MS(默认 2000 ms):按故障处理,计入熔断统计; - 回调抛异常:同样被平台捕获、记故障,不会把整站打挂;
- 同类故障在统计窗口内频繁出现:插件会被自动熔断停用,站长后台可重置熔断后重试。
> 上面的数值以核心常量为准(本页取不到核心时展示的是默认值);阈值由站长/核心版本决定,插件无法改。
哪些钩子最容易拖慢站点
渲染注入区(每个页面都会跑,最危险):
plugin_render_body_topplugin_render_footerplugin_render_headplugin_render_nav_extraplugin_render_profile_cardsplugin_render_settings_cards
还包括所有标注「任意请求都会触发」的动作/过滤器(发布、评论、响应改写等,见「扩展点全表」的触发时机说明)。这些钩子里的每一毫秒都会被所有访客一起承担。
优化建议(照做基本不会触发熔断)
1. 渲染钩子里只拼字符串:需要的数据提前算好、缓存好,不在钩子里 SELECT、file_get_contents、pluginHttp()。
2. 用定时任务做重活:registerPluginCron() 适合清理、同步、汇总;间隔最小 60 秒,由站点流量驱动。
3. 缓存热点数据:把统计结果写进插件自己的表或设置项,按需刷新,而不是每次请求重算。
4. 给外部请求设超时与上限:pluginHttp() 已带超时与体积上限;自己写 curl 时务必设置 CURLOPT_TIMEOUT。
5. 限制数据量:列表/统计加上 LIMIT,别在钩子里做全表扫描或大数组排序。
6. 前缀钩子从简:api_request 这类进入即触发的钩子里只做轻量判断,不要做重活。
7. 本地先量一下:在测试站用浏览器开发者工具看页面耗时,或临时打点,确认插件带来的开销在可接受范围。