Composer 安装 iter 库失败因 nikic/iter 已归档且不兼容 PHP 8.1+，需手动添加 GitHub VCS 仓库并限定 dev-master 与 PHP ≤8.0；推荐改用原生生成器实现 map/filter/take 或采用 spatie/sequence 等现代替代方案。
Composer 安装 iter 库失败：找不到包名
iter 库没有在 Packagist 上注册为 iter 或 php-iter，直接运行 composer require iter 会报错 Could not find package iter。它实际是 GitHub 上的开源项目，作者是 nikic，原仓库名为 nikic/iter，但该库早已归档（archived），不再维护，且不兼容 PHP 8.1+ 的生成器返回类型声明。
目前更可靠、活跃维护的替代方案是 spatie/sequence 或手写轻量级生成器工具；但若明确需要 nikic/iter 的 API 风格，必须手动添加仓库：
- 在
composer.json的"repositories"字段中添加 GitHub VCS 源："repositories": [ { "type": "vcs", "url": "https://github.com/nikic/iter" } ] - 再执行
composer require nikic/iter:dev-master（注意：仅限开发环境，不建议上线） - PHP 版本需 ≤ 8.0；PHP 8.1+ 会因
Generator::key(): mixed等类型冲突导致 fatal error
用 yield 写一个等效的 minimal iter 工具函数
与其依赖已归档的库，不如用原生生成器几行写出核心能力——比如 map、filter、take。这些函数本质就是包装 yield from 和 yield，无额外开销：
function map(callable $fn, iterable $iterable) {
foreach ($iterable as $item) {
yield $fn($item);
}
}
<p>function filter(callable $fn, iterable $iterable) {
foreach ($iterable as $item) {
if ($fn($item)) {
yield $item;
}
}
}</p><p>function take(int $n, iterable $iterable) {
$count = 0;
foreach ($iterable as $item) {
if ($count >= $n) break;
yield $item;
$count++;
}
}使用示例：iterator_to_array(take(3, map(fn($x) => $x * 2, range(1, 10)))) → [2, 4, 6]。全程无数组中间态，内存占用恒定。
立即学习“PHP免费学习笔记（深入）”；
为什么不要在 Laravel 或 Symfony 项目里硬塞 nikic/iter
主流框架已内置类似能力，强行引入旧版 iter 会引发冲突：
- Laravel 的
Illuminate\Support\LazyCollection提供链式map/filter，底层基于生成器，且支持异步、分块、序列化 - Symfony 的
Symfony\Component\String\UnicodeString和Iterable组件已覆盖大部分迭代场景 - nikic/iter 的
Iter类与 Laravel 的Collection命名空间或自动加载规则可能重叠，触发Class not found或 silent 覆盖 - 它的
__invoke()用法（如(new Iter([1,2]))->map(...)）和现代 PHP 的函数式风格不一致，增加团队理解成本
真正高效的迭代器操作，关键不在库而在控制权
生成器性能优势的前提是：数据源本身支持逐条产出（如 PDOStatement、文件句柄、API 流式响应）。如果源头已是完整数组（range(1, 1000000)），用任何“迭代器库”都救不了内存——因为 range 本身已分配全部内存。
真正要检查的是：
- 数据库查询是否用了
cursor()或chunk()，而非get() - 大文件读取是否用
fopen + fgets，而非file_get_contents - 第三方 API 是否提供流式 JSON 解析（如
json_decode($json, false, 512, JSON_STREAMING)，虽然 PHP 原生不支持，但可用json-stream类库）
库只是胶水，数据流动方式才是瓶颈所在。
