用 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+ 项目里还多写一层手动判断，纯属冗余。版本号得盯紧。