将嵌套 foreach 树结构转换为通用递归 PHP 函数-php教程-PHP中文网

将嵌套 foreach 树结构转换为通用递归 PHP 函数

本文介绍如何将深度未知的多层嵌套树形数组（含对象）通过递归函数统一提取各层级节点 id，按 depth 键分组聚合，替代冗长且不可扩展的多层 foreach 嵌套。

本文介绍如何将深度未知的多层嵌套树形数组（含对象）通过递归函数统一提取各层级节点 id，按 depth 键分组聚合，替代冗长且不可扩展的多层 foreach 嵌套。

在处理树形结构数据（如分类目录、组织架构、评论回复链等）时，常遇到节点深度动态变化的问题。原始代码使用 5–6 层嵌套 foreach 手动遍历 $val->children，不仅难以维护，更无法应对任意深度（如 depth=10 或更深）的场景，违反了“一次编写、无限适配”的工程原则。

理想的解决方案是递归遍历 + 引用传参聚合：定义一个可自调用的递归函数，对每个节点提取 $val->tid 并存入以 $val->depth 为键的二维数组中；当遇到子节点（$val->children）时，递归调用自身继续处理——无需预判深度，天然支持无限层级。

以下是完整、健壮、可直接复用的递归实现：

/**
 * 递归收集树节点：按 depth 分组 tid
 * @param array|object $item 当前层级节点集合（通常为数组，元素为对象）
 * @param array &$data 引用传递的结果容器，格式为 [$depth => [$tid, ...]]
 * @return void
 */
function collectTermsByDepth($item, &$data) {
    // 安全防护：跳过空值、非对象/非数组类型
    if (empty($item) || (!is_array($item) && !is_object($item))) {
        return;
    }

    // 统一转为数组便于遍历（兼容 stdClass 或 Traversable 对象）
    $items = is_object($item) && method_exists($item, 'getIterator') 
        ? iterator_to_array($item) 
        : (is_array($item) ? $item : []);

    foreach ($items as $val) {
        // 确保当前节点是对象且含必要属性
        if (is_object($val) && isset($val->depth) && isset($val->tid)) {
            $data[$val->depth][] = $val->tid;
        }

        // 递归处理子树（children 可能为 null、空数组或对象数组）
        if (isset($val->children) && !empty($val->children)) {
            collectTermsByDepth($val->children, $data);
        }
    }
}

/**
 * 入口函数：封装递归逻辑，返回标准化结果
 * @param array|object $tree 根节点集合
 * @return array [$depth => [$tid, ...]]
 */
function buildTermTreeByDepth($tree) {
    $result = [];
    collectTermsByDepth($tree, $result);
    ksort($result); // 可选：按 depth 升序排列，保证输出一致性
    return $result;
}

✅ 使用示例：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

// 假设 $tree 是你的原始树形数据（数组，元素为含 depth/tid/children 的对象）
$result = buildTermTreeByDepth($tree);
print_r($result);
// 输出结构与题目要求完全一致：Array[0], Array[1], ...

⚠️ 关键注意事项：