确认 PHP 变量是否为一维数组需综合多种方法:一、比对 array_keys()与 range()并检查值非数组;二、比较 count()与 count(…, COUNT_RECURSIVE)是否相等;三、遍历判断所有元素均非数组;四、var_export()字符串分析仅限调试;五、反射类封装检测逻辑。

如果您需要确认一个 PHP 变量是否为一维数组,或在运行时准确识别其维度结构,则不能仅依赖 is_array() 函数,因为该函数无法区分一维、二维或多维数组。以下是几种可靠且互不依赖的检查方法:
一、使用 array_keys()与 array_values()比对索引连续性
该方法通过验证数组键是否为从 0 开始的连续整数序列,并且值未嵌套数组,来间接判定是否为严格的一维索引数组。它适用于需排除关联键或嵌套结构的场景。
1、调用 array_keys($arr) 获取所有键名。
2、使用 range(0, count($arr) - 1) 生成期望的连续整数键序列。
3、用 === 比较两者是否完全相等。
4、再遍历每个值,使用 !is_array($value) 确保无任何元素为数组类型。
二、递归检测嵌套深度(count()配合 COUNT_RECURSIVE)
利用 count() 函数的两种计数模式差异可推断维度:若普通计数与递归计数结果一致,说明内部无子数组,即为一维;若递归计数更大,则存在至少一个嵌套层级。
1、执行 $normal = count($arr); 获取顶层元素数量。
2、执行 $recursive = count($arr, COUNT_RECURSIVE); 获取全部标量及子数组元素总数。
3、比较 $normal === $recursive,结果为true 时表明 无任何嵌套数组,确认为一维。
三、遍历并检查每个值的类型
此方法直接对数组每个值进行类型探测,只要发现任一元素是数组类型,即可立即否定一维判定;若全部遍历完毕均非数组,则可确认为一维。
1、使用 foreach ($arr as $item) 逐个访问元素。
2、在循环体内调用if (is_array($item)) {return false;}。
3、循环结束后未触发返回,则 返回 true 表示该数组确为一维。
四、使用 var_export()字符串分析(仅限调试环境)
该方式不用于生产逻辑判断,但可在开发调试中快速肉眼识别维度:通过导出数组结构文本,观察是否存在 array( 嵌套出现。适用于临时验证或日志输出场景。
1、执行 $export = var_export($arr, true); 获取格式化字符串。
2、统计子字符串 'array(' 在整个输出中出现的次数。
3、若出现次数大于 1,则 表明存在嵌套,非一维;等于 1 则可能为一维(需结合键值结构进一步验证)。
五、借助 ReflectionClass 反射获取内部结构(高级用法)
PHP 反射机制无法直接暴露数组维度,但可通过构造辅助对象封装数组,并在其__toString 或自定义方法中嵌入维度标记逻辑。此法适用于需统一管理多种数据结构的框架层设计。
1、定义类ArrayInspector,构造函数接收目标数组并存储。
2、在类中实现 getDimension() 方法,内部调用前述任一可靠检测逻辑。
3、实例化后调用 $inspector->getDimension() === 1 即可判定是否为一维。