PHP-Hooks 库中实现多钩子并行执行并收集全部返回值的正确方法

php-hooks 库的 `apply_filters()` 默认仅返回最后一个钩子的处理结果；若需收集所有钩子的返回值，须显式遍历多个独立钩子名并逐个调用，而非复用同一钩子名注册多个回调。

PHP-Hooks（bainternet/PHP-Hooks）是一个轻量级的 WordPress 风格钩子系统，其 add_filter() 支持为同一个钩子名（hook name） 添加多个回调函数，但 apply_filters() 的设计逻辑是链式传递：前一个回调的返回值会作为下一个回调的输入参数，最终只返回最后一个回调的返回值。这与 WordPress 原生行为一致，但不同于“并行收集所有回调结果”的需求。

在你的代码中：

app_hooks()->add_filter('my_filter', fn($v) => { echo $v; return "x"; });
app_hooks()->add_filter('my_filter', fn($v) => { echo $v; return "y"; });

两次均注册到 'my_filter' 这一钩子名下。当执行：

app_hooks()->apply_filters('my_filter', 'some value to be passed')

实际执行流程为：

1. 第一个回调接收 'some value to be passed' → 输出该字符串 → 返回 "x"；
2. 第二个回调接收上一步返回的 "x"（而非原始字符串）→ 输出 "x" → 返回 "y"；
3. apply_filters() 最终只返回 "y"。

因此 $my_tabs 仅含一个元素 ['y']，且第二次 echo 输出的是 "x"（非预期的 "some value to be passed"），印证了值的链式传递特性。

✅ 正确解法：为每个逻辑独立的处理逻辑分配唯一钩子名，并手动循环调用

// 注册两个语义清晰、互不干扰的钩子
app_hooks()->add_filter('my_filter_x', function ($value) {
    echo $value; // 输出: some value to be passed
    return "x";
});
app_hooks()->add_filter('my_filter_y', function ($value) {
    echo $value; // 输出: some value to be passed（两次都收到原始值）
    return "y";
});

// 显式调用每个钩子，原始值分别传入，结果独立收集
$my_tabs = [];
$original_value = 'some value to be passed';
foreach (['my_filter_x', 'my_filter_y'] as $hook_name) {
    $my_tabs[] = app_hooks()->apply_filters($hook_name, $original_value);
}

print_r($my_tabs);
// 输出：
// Array
// (
//     [0] => x
//     [1] => y
// )

⚠️ 注意事项：

• 不要依赖单个钩子名承载多个“并行”意图的回调——这是对钩子机制的误用；
• 若业务上确需统一入口（如 'my_filter'）但又要获取全部结果，可自行封装一个辅助函数，内部遍历 get_filters('my_filter') 获取所有回调并逐一执行（需确保库支持 get_filters 或通过反射访问内部存储）；
• PHP-Hooks 默认不提供 apply_filters_all() 类似 WordPress 的 apply_filters_ref_array() 多返回模式，扩展需谨慎，避免破坏链式过滤的语义一致性。

总结：钩子系统的本质是「值变换管道」，而非「回调广播中心」。明确区分「链式处理」与「并行采集」场景，合理设计钩子命名策略，是正确使用 PHP-Hooks 的关键。