is_iterable用于判断变量是否可在foreach中使用,包括数组和Traversable对象。示例:$items = [1,2,3]; $obj = new ArrayIterator(['a','b','c']); is_iterable($items)和$obj均返回true,而字符串"hello"返回false。相比仅用is_array或instanceof Traversable,is_iterable能统一处理两类可迭代数据。PHP 7.1+原生支持,旧版本可用is_array($var) || $var instanceof Traversable替代。建议在接收列表型参数时使用is_iterable校验,提升代码健壮性与兼容性,尤其适用于通用数据处理器、集合类或API封装。

在 PHP 中,is_iterable 是一个用于检测变量是否为“可迭代”(iterable)的内置函数。它能兼容数组和实现了 Traversable 接口的对象,是编写通用遍历逻辑时非常实用的类型判断工具。
is_iterable 的作用与使用场景
is_iterable 函数返回布尔值,用来判断一个变量是否可以在 foreach 中安全使用。这包括:
- 普通数组(indexed 或 associative)
- 通过 ArrayIterator 等实现 Traversable 接口的对象
- 任何实现了 Iterator 或 IteratorAggregate 接口的类实例
$items = [1, 2, 3];
$obj = new ArrayIterator(['a', 'b', 'c']);
var_dump(is_iterable($items)); // true
var_dump(is_iterable($obj)); // true
var_dump(is_iterable("hello")); // false
与 is_array 和 instanceof Traversable 的对比
如果你只用 is_array,会漏掉对象形式的可迭代数据;而仅检查 instanceof Traversable 又会排除数组。使用 is_iterable 能统一处理这两类情况。
等价替代写法(适用于不支持 is_iterable 的旧版本 PHP):
立即学习“PHP免费学习笔记(深入)”;
function my_is_iterable($var) {
return is_array($var) || $var instanceof Traversable;
}
注意:PHP 7.1+ 原生支持 is_iterable,无需自行封装。
实际应用建议
当你编写接受“列表”型参数的函数时,推荐优先使用 is_iterable 进行校验,提高灵活性。
- 适合构建通用的数据处理器、集合类或 API 返回封装
- 避免因传入对象而非数组导致 foreach 报错
- 配合类型声明更安全:
function process($data) { if (!is_iterable($data)) { throw new TypeError('Expected iterable'); } }











