PHP 如何判断数组是几维数组

拾光

发布时间：2026-10-14 | 4人浏览过

原创

在处理复杂数据结构时，确定数组的具体维度往往能帮助我们选择合适的处理方式。本内容介绍了一种基于递归原理的 PHP 函数，用于精确计算任意不规则数组的最大嵌套层级。

为什么需要计算数组维度

PHP 中的数组天然支持多维结构，但在进行数据解析或格式化输出前，明确其维度有助于优化代码逻辑。例如，在处理从外部接口接收到的 JSON 数据时，了解数组的深度可以帮助开发者决定是使用简单的循环还是递归渲染模板。虽然 PHP 标准库中没有直接提供 "getArrayDimension" 这样的内置函数，但通过简单的递归逻辑即可轻松实现。

实现原理与代码

核心思路是利用递归函数遍历数组的每一个元素。如果遇到的是子数组，则当前层级加 1，并继续深入遍历；如果遍历结束，则记录当前路径的最大层级。最终比较所有路径得到的层级值，取最大值即为该数组的维度。

以下是完整的 PHP 实现代码：

<?php
/**
 * 返回数组的维度（最大嵌套层数）
 * @param array $arr 待检测的数组
 * @return int 数组的维度
 */
function arrayLevel($arr){
    // 初始化一个数组用于存储各级别的深度值
    $al = array(0);
    
    // 定义内部递归辅助函数
    function aL($arr, &$al, $level=0){
        if(is_array($arr)){
            $level++;
            $al[] = $level;
            foreach($arr as $v){
                // 递归调用，传入当前值和深度累加器引用
                aL($v, $al, $level);
            }
        }
    }
    
    // 执行递归遍历
    aL($arr, $al);
    
    // 返回所有记录层级中的最大值
    return max($al);
}
?>

关键步骤说明

第1步：初始化状态容器

首先创建一个名为 $al 的数组，初始值为 0。这个数组将作为“深度日志”，每次递归进入新的一层时，就将当前的 $level 追加进去。这样无论数组结构多么复杂，所有的层级深度都会被记录下来。

第2步：执行递归遍历

调用内部的 aL 函数。该函数接收三个参数：当前节点数组 $arr、深度引用数组 $al 以及当前层级计数器 $level（默认从 0 开始）。

入口判断：使用 is_array() 检查当前输入是否为数组。如果不是（即到达了叶子节点），则不再递归，直接返回上一层。
层级增加：如果是数组，说明进入更深的一层，$level 自增 1。
记录深度：将当前的 $level 存入 $al 数组，确保这一层的深度被保存。
子节点处理：使用 foreach 遍历当前数组的所有值，并对每个值再次调用 aL 函数，形成深度优先搜索的路径。

第3步：获取最大维度

当 aL 函数完成对整个结构的遍历后，$al 数组中包含了所有经过的层级节点。由于我们关心的是整个数组的最深层级，因此使用 max($al) 找出其中的最大值并返回。这代表了从根节点到最深叶节点的边数，即数组的维度。

使用示例

可以通过以下测试验证函数的准确性：

$arr1 = array(1, 2, 3);
$arr2 = array(array(1, 2), array(3, 4));
$arr3 = array(array(array('a'), 'b'), 'c');

echo arrayLevel($arr1); // 输出 1
echo arrayLevel($arr2); // 输出 2
echo arrayLevel($arr3); // 输出 3

注意：上述代码中，一维数组维度记为 1，二维为 2，以此类推。如果传入非数组类型，可能需要额外增加类型检查以防止错误。

注意事项与排错

性能考量：对于极度庞大的数组，递归可能导致栈溢出。在实际生产环境中，如果数组层级极深且数据量巨大，建议考虑迭代方式或限制最大遍历深度。
非均匀数组：该函数同样适用于“锯齿状”数组（即不同分支深度不同），因为它会探索所有路径并取最大值。
空数组：如果传入空数组 array()，函数将返回 0 或 1（取决于是否将空数组本身视为一层）。根据当前代码逻辑，空数组不会进入 if(is_array) 的增量逻辑，$al 仍为 [0]，故返回 0。如需将空数组视为 1 维，可调整初始逻辑。