php递归获取无限级栏目列表时,parent_id必须统一用0标识根节点;需全量查询后用引用传参递归组装树,或用array_reduce一次性构建;输出时须防xss并显式传递层级参数。

PHP递归获取无限级栏目列表时,parent_id字段必须为0或NULL作根节点标识
很多CMS或自建系统中,栏目表用id和parent_id实现树形结构。直接SELECT * FROM category只能拿到扁平数据,要转成带层级的列表,核心是识别根节点——常见错误是把parent_id = NULL和parent_id = 0混为一谈,导致第一层漏掉或重复。数据库里统一用0表示顶级更稳妥,代码里也只需判断$row['parent_id'] == 0即可。
实际遍历时建议先全量查出所有数据,再用PHP组织树,而不是每层都发SQL(避免N+1问题):
SELECT id, name, parent_id, sort FROM category ORDER BY sort ASC, id ASC
这样能保证同级栏目按sort排序,后续递归时顺序可控。
用buildTree()函数递归组装时,必须传入引用参数&$tree
PHP中数组默认值传递,递归过程中若不加引用,子级数据无法写回上层结构。典型错误写法是buildTree($items, $pid)返回新数组,但嵌套深了容易内存溢出或逻辑断裂。
立即学习“PHP免费学习笔记(深入)”;
- 正确做法:初始化空数组
$tree = [],调用buildTree($items, 0, $tree),函数内部用&$tree接收 -
buildTree()内部对每个匹配$pid的节点,先追加到$tree,再用其id作为下一轮$pid递归找子项 - 如果栏目深度可能超10级,建议加递归深度限制(比如
$level ),防止意外死循环
使用array_reduce()一次性生成树结构,避开手动递归
对熟悉函数式风格的同学,可以用array_reduce()配合闭包一次构建完整树,逻辑更紧凑,也不用担心引用或深度控制:
$map = [];
foreach ($rows as $row) {
$map[$row['id']] = $row + ['children' => []];
}
$tree = [];
foreach ($rows as $row) {
if ($row['parent_id'] == 0) {
$tree[] = &$map[$row['id']];
} else {
$map[$row['parent_id']]['children'][] = &$map[$row['id']];
}
}关键点在于两次&:一次让$tree持有引用,一次让子项写入父级children时同步生效。这种写法性能好、无递归开销,适合500条以内的栏目数据。
输出HTML菜单时,htmlspecialchars()不能漏,且level参数要显式传入
生成<ul><li></ul>结构时,常需要根据层级加class或缩进。如果递归函数没把当前$level作为参数透传下去,就只能靠字符串前缀模拟,极易错乱。
- 模板渲染环节务必对
$item['name']做htmlspecialchars($item['name'], ENT_QUOTES, 'UTF-8'),防XSS - 推荐在
renderMenu($tree, $level = 0)中显式传$level,方便加menu-level-{$level}类或data-depth属性 - 如果前端要用JS展开/折叠,建议后端直接输出
has_children: true/false字段,比前端查children.length更可靠
无限级栏目的难点不在“怎么遍历”,而在于parent_id语义是否清晰、引用是否到位、层级上下文是否连续——这三个地方任一出错,都会导致菜单缺项、错层或报Maximum function nesting level。











