用 is_array() 判断变量是否为数组最可靠,它只对原生数组返回 true,对 null、对象、JSON 解码失败结果等均正确返回 false,且不替代类型声明或兼容伪数组结构。

用 is_array() 判断变量是否为数组最可靠
PHP 中判断一个变量是不是数组,唯一推荐、无歧义的方式就是用 is_array()。它不关心数组是索引数组、关联数组还是空数组,只要底层类型是 array 就返回 true。
常见误判场景包括:NULL、stdClass 对象、Traversable 实现类(如 ArrayIterator)、JSON 解码失败后的 NULL——这些都不能靠 is_array() 误判,它只认原生数组。
-
is_array([])→true -
is_array(['a' => 1])→true -
is_array(null)→false -
is_array((object)['a' => 1])→false -
is_array(json_decode('{"a":1}'))→false(默认返回对象)
别用 gettype() 或 get_class() 替代 is_array()
gettype() 虽然能返回 "array",但它是字符串比较,多一层间接且易出错;get_class() 对数组直接报错(Fatal error: Uncaught TypeError: get_class(): Argument #1 ($object) must be of type object),完全不可用。
更隐蔽的坑是:有人试图用 is_object($var) === false && !is_null($var) 推断“可能是数组”,这在遇到字符串、整数、布尔值时会误判,逻辑漏洞明显。
立即学习“PHP免费学习笔记(深入)”;
- ✅ 正确:
if (is_array($data)) { ... } - ❌ 危险:
if (gettype($data) === 'array') { ... } - ❌ 报错:
get_class($data)(当 $data 是数组时)
json_decode() 后必须显式判断数组类型
很多人以为 json_decode($json, true) 总是返回数组,但若 JSON 字符串非法或为空,它可能返回 null;若没加第二个参数 true,则返回对象——这时候 is_array() 就是必检步骤。
典型错误写法:$arr = json_decode($json); foreach ($arr as $k => $v) {...},一旦 $json 解析失败,$arr 是 null,foreach 会警告。
- 安全写法:
$data = json_decode($json, true); if (is_array($data)) { ... } - 注意:
json_decode('{}')返回空对象,json_decode('{}', true)才返回[] - 如果 JSON 可能是数组或对象混合结构,不能只依赖
is_array(),需结合isset()或键名检查
自定义函数封装要小心引用和类型擦除
有人为了“统一判断”写类似 isArrayLike() 的函数,试图兼容 ArrayAccess、Traversable 等,但这会模糊 PHP 类型系统的边界。PHP 的数组是值类型、有特定内存布局和函数支持(如 array_merge()、count()),而对象即使实现 ArrayAccess 也不能直接传给原生数组函数。
除非业务明确要求“行为像数组即可”,否则不要绕过 is_array()。尤其注意:函数参数用 array 类型声明时,PHP 8+ 会严格拒绝对象,此时 is_array() 检查比运行时类型转换更早暴露问题。
- 类型声明强制校验:
function process(array $items) { ... },传对象直接 fatal -
is_array()是运行时兜底,不是替代类型系统 - 对
ArrayObject或Doctrine\Common\Collections\Collection,应单独处理,不混为数组
is_array() 校验,尤其是那些接受“数组或 null”的参数——null 不报错,但后续 foreach 或 array_keys() 会崩。











