PHP iterable和array有什么区别-php教程-PHP中文网

iterable 是 array|traversable 的编译时别名，非具体类型；它接受数组及任意 traversable 对象（如 arrayobject、generator），而 array 仅接受原生数组，故 arrayobject、生成器等可传给 iterable 却不被 array 接受。

php iterable和array有什么区别

iterable 不是具体类型，而是 array|Traversable 的编译时别名；它不表示“某种数组”，而是一种契约：只要能被 foreach 消费，就满足要求。

iterable 能接受哪些值，array 不能？

关键区别在于运行时兼容范围：

iterable 可以是 array，也可以是任意实现了 Iterator、IteratorAggregate 或其他 Traversable 子接口的对象（比如 ArrayObject、SimpleXMLIterator、自定义分页器）
array 类型声明只接受 PHP 原生数组，传入 ArrayObject 会直接报 TypeError
生成器函数返回 iterable 是合法的，但不能声明返回 array —— 因为生成器不是数组，它延迟产出值

示例：

function accepts_iterable(iterable $i): void { foreach ($i as $v) { echo $v; } }
function accepts_array(array $a): void { foreach ($a as $v) { echo $v; } }

$gen = function() { yield 'a'; yield 'b'; };
$obj = new ArrayObject(['x', 'y']);

accepts_iterable($gen()); // ✅ OK
accepts_iterable($obj);   // ✅ OK
accepts_array($obj);       // ❌ TypeError: Argument #1 must be of type array

声明参数为 iterable 时，为什么有时反而更严格？

表面看 iterable 更宽泛，但在类型继承和方法重写中，它可能触发更严格的协变/逆变检查：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

父类方法参数声明为 iterable，子类重写时可缩小为 array 或具体 Traversable 子类（如 ArrayObject）
但若父类参数是 array，子类不能扩大为 iterable —— 这会破坏调用方对“一定是数组”的预期
错误常出现在 IDE 提示或静态分析工具（如 PHPStan）中，而非运行时报错

典型报错信息：Parameter of method Child::foo() has type iterable, but parent method Parent::foo() has type array

用 iterable 替代 array 会影响性能或反射吗？

几乎无运行时开销，但要注意两处隐性差异：

类型反射中，ReflectionParameter::getType() 对 iterable 返回 ReflectionNamedType，名字是 "iterable"；但在联合类型中（如 iterable|int），它会被展开为 array|Traversable|int
错误消息里不再显示 iterable，而是 array|Traversable —— 这是 PHP 编译期替换的结果，调试时容易困惑
没有额外内存或迭代开销：PHP 内部对 iterable 的处理和直接写 array|Traversable 完全一致