php怎么判断变量为数组类型_php数组类型判断函数用法【示例】

1次阅读

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

php怎么判断变量为数组类型_php数组类型判断函数用法【示例】

is_array() 判断变量是否为数组最可靠

php 中判断一个变量是不是数组,唯一推荐、无歧义的方式就是用 is_array()。它不关心数组是索引数组、关联数组还是空数组,只要底层类型是 array 就返回 true

常见误判场景包括:NULLstdClass 对象、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 解析失败,$arrnullforeach 会警告。

  • 安全写法:$data = json_decode($json, true); if (is_array($data)) { ... }
  • 注意:json_decode('{}') 返回空对象,json_decode('{}', true) 才返回 []
  • 如果 JSON 可能是数组或对象混合结构,不能只依赖 is_array(),需结合 isset() 或键名检查

自定义函数封装要小心引用和类型擦除

有人为了“统一判断”写类似 isArrayLike() 的函数,试图兼容 ArrayaccessTraversable 等,但这会模糊 PHP 类型系统的边界。PHP 的数组是值类型、有特定内存布局和函数支持(如 array_merge()count()),而对象即使实现 ArrayAccess 也不能直接传给原生数组函数。

除非业务明确要求“行为像数组即可”,否则不要绕过 is_array()。尤其注意:函数参数用 array 类型声明时,PHP 8+ 会严格拒绝对象,此时 is_array() 检查比运行时类型转换更早暴露问题。

  • 类型声明强制校验:function process(array $items) { ... },传对象直接 fatal
  • is_array() 是运行时兜底,不是替代类型系统
  • ArrayObjectDoctrineCommonCollectionsCollection,应单独处理,不混为数组

实际项目里最容易被忽略的是:在函数入口处忘记对可选参数做 is_array() 校验,尤其是那些接受“数组或 null”的参数——null 不报错,但后续 foreacharray_keys() 会崩。

text=ZqhQzanResources