
用 is_iterable() 是最直接的判断方式
PHP 7.1+ 原生提供了 is_iterable() 函数,它能准确识别数组、Traversable 对象(如 Iterator、Generator、ArrayObject 等),返回布尔值。这是唯一推荐的「语义正确」方式。
常见错误是用 is_array() 或 instanceof Traversable 单独判断——前者漏掉对象,后者漏掉数组,两者合用又啰嗦且易出错。
-
is_iterable([])→true -
is_iterable(new ArrayObject())→true -
is_iterable("hello")→false -
is_iterable(null)→false
PHP 7.0 及更早版本只能手动模拟
没有 is_iterable() 时,必须组合判断:先看是不是数组,再看是否实现了 Traversable 接口。注意不能用 is_object() 加 method_exists($v, "getIterator"),因为不是所有可迭代对象都有该方法(比如 Generator 就不行)。
- 必须同时检查
is_array($v) || $v instanceof Traversable - 不要用
foreach块包裹 +try/catch捕获异常——这属于运行时试探,开销大且不严谨(比如某些对象可能只在遍历时才抛异常) - 如果项目已升级到 PHP 7.1+,就别写兼容函数了,徒增维护负担
别把 is_countable() 当成替代方案
is_countable() 是 PHP 7.3+ 引入的,但它和可迭代性无关:它只判断能否用 count(),而很多可迭代对象(如 Generator)不可计数,反过来,有些可计数的对象(如 Countable 实现类)未必可迭代。
立即学习“PHP免费学习笔记(深入)”;
-
is_countable(new Generator())→false,但它是可迭代的 -
is_iterable(new SplFixedArray(3))→true,但is_countable()在 PHP - 两者语义不同,混用会导致逻辑漏洞,尤其在类型断言或泛型模拟场景下
在函数参数类型声明中无法直接约束可迭代性
PHP 不支持 iterable 作为独立类型声明(虽然 iterable 是伪类型,可用于文档注释或 PHPStan/ Psalm 静态分析),但你可以在运行时用 is_iterable() 做防御性检查。
- 别写
function foo(iterable $data)—— 这会报语法错误(PHP 8.0+ 才支持iterable作为参数类型) - PHP 8.0+ 允许
function foo(iterable $data),此时引擎自动校验,无需手动调用is_iterable() - 低于 PHP 8.0 的项目,必须显式检查:
if (!is_iterable($data)) { throw new TypeError(...); }
is_iterable() 一直存在,结果在老环境里直接 fatal error;或者在 PHP 8.0+ 项目里还多写一层手动判断,纯属冗余。版本号得盯紧。











