求助：PHP自定义钩子因addHook晚于addToHead调用导致失效

PHP为顺序执行脚本，当前调用链路完全颠倒，触发钩子的动作（执行addToHead）发生在所有钩子注册动作（执行addHook）之前，属于典型的时序错位：

• 加载基础函数文件时，全局$hooks仅完成空数组初始化
• 立刻引入头部模板执行addToHead()时，$hooks数组内没有任何已注册的head回调，函数执行无任何有效输出
• 后续业务逻辑执行到addHook('head', 回调函数)的注册动作时，页面头部已经完成渲染输出，注册的回调永远无法被触发

调整全局执行时序（推荐优先级最高） #

把所有钩子注册环节前置到头部模板渲染之前，理顺标准钩子系统的执行逻辑：

• 先加载核心函数文件，完成$hooks全局变量、addHook、addToHead等基础能力的定义
• 加载所有业务模块、执行业务逻辑中的全部addHook注册动作，把所有需要挂载到head位置的回调提前存入$hooks['head']数组
• 最后引入头部模板文件，执行addToHead()触发已注册的所有回调

参考示例代码：

// 加载核心钩子能力定义
require './functions.php';

// 先加载业务模块，完成所有钩子注册
require './modules/seo.php'; // 模块内执行 addHook('head', 'output_meta_tags')
require './modules/analytics.php'; // 模块内执行 addHook('head', 'output_track_code')

// 最后渲染头部模板，此时所有回调已完成注册
require './head.php';

输出缓冲适配（兼容无法前置的业务场景） #

如果存在必须在头部渲染流程启动后，才能获取数据、完成钩子注册的特殊场景，通过PHP输出缓冲暂存内容，等所有注册动作完成后再统一输出：

• 改造addToHead，不再直接将回调内容输出到浏览器，把所有head钩子的输出暂存到全局变量中
• 保留原流程在头部模板位置调用addToHead的动作，此时即便没有已注册的回调，也不会产生无效的空输出
• 等后续所有业务逻辑执行完、所有head回调注册完成后，再统一把所有回调生成的内容追加到暂存的head内容中
• 最终渲染页面时，把拼合完成的完整head内容输出

配套改造的addToHead代码：

$head_buffer = '';
function addToHead() {
    global $hooks, $head_buffer;
    ob_start();
    // 直接取对应钩子的回调列表，去掉原实现全量遍历数组的冗余逻辑
    if (!empty($hooks['head'])) {
        foreach ($hooks['head'] as $callback) {
            call_user_func($callback);
        }
    }
    // 把生成的内容暂存，不直接输出
    $head_buffer .= ob_get_clean();
}

原函数冗余逻辑优化 #

原有addToHead实现中，通过全量遍历$hooks数组匹配head键的嵌套循环逻辑效率极低，完全可以直接通过数组键值定位，减少无意义的循环开销：

• 去掉全量遍历$hooks、判断$hook == 'head'的嵌套循环结构
• 直接判断$hooks['head']是否存在非空数组，存在则遍历执行对应回调

内容的提问来源于stack exchange，提问作者Bert