Hyperf中foreach遍历大数组爆内存，根本原因不是foreach语法，而是select()/get()已将全部数据一次性加载进内存；cursor()仅在单表查询、禁用缓冲、不调全量方法时才真正流式取数。
Hyperf里foreach遍历大数组为啥爆内存
不是foreach本身的问题，而是你遍历的“那个数组”根本不是逐行取的——它早被select()或all()一次性全加载进 PHP 内存了。Hyperf 的 Db::table()->select() 或 Eloquent 的 get() 默认返回完整集合对象，哪怕你后面用 foreach，数据早已在内存里躺着。
常见错误现象：$users = User::where('status', 1)->select('id', 'name')->get(); foreach ($users as $u) { ... } —— 这里 get() 已把几万条记录全塞进内存，foreach 只是“读”，不“减”内存。
- PHP 数组在 7.4+ 虽有写时复制优化，但
get()返回的是完整Collection，每个模型实例都带属性、关系、变更跟踪，开销远超原始数据 - Hyperf 默认使用 PDO 缓冲查询（
PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => true），结果集一次性 fetch 全部，无法释放 - 即使只选两三个字段，ORM 层仍会构造完整模型对象，字段映射、类型转换、访问器等逻辑照常执行
Hyperf 的 cursor() 方法到底能不能省内存
能，但只在满足三个硬性条件时才生效：
- 必须是单表查询（无
join、无with()关联预加载） - 不能调用任何触发全量加载的方法（如
toArray()、jsonSerialize()、count()、first()） - 必须直接
foreach遍历，且循环体内不缓存整批结果（比如不往一个大数组里[] = $row）
正确写法：foreach (User::where('status', 1)->cursor() as $user) { process($user); }
错误写法：$cursor = User::where('status', 1)->cursor(); $list = $cursor->all(); // 此刻已全量加载
注意：Hyperf 当前版本（v3.0+）的 cursor() 底层依赖 PDO 的无缓冲模式（PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => false）。若数据库连接配置没关缓冲，它会静默退化为每 1000 条一次的模拟分页，虽比全量好，但不是真正游标。
cursorPaginate() 和手动游标推进的区别
cursorPaginate() 是封装好的分页响应，适合 HTTP 接口返回；而“手动游标推进”是纯服务端批处理逻辑，两者目的不同，别混用。
-
cursorPaginate(100)：返回LengthAwarePaginator，含nextCursor参数（base64 编码），供前端翻页；它强制要求orderBy('id')，且只支持单字段排序；每次请求都重新查一次，不维持长连接 - 手动推进（如
where('id', '>', $lastId)->limit(1000)->get()）：你完全控制循环节奏、中断点、错误重试；必须确保id字段有索引且单调递增；适合 CLI 命令、队列任务等长时间运行场景 - 关键区别：前者是“响应式分页”，后者是“状态驱动迭代”。用错场景会导致重复处理或漏数据——比如在消息队列中用
cursorPaginate()，两次拉取之间新插入的数据可能被跳过
为什么关联查询下 cursor() 失效还很慢
Hyperf 的 cursor() 在遇到 with()、join()、groupBy() 或子查询时，ORM 层会直接放弃游标逻辑，回退到 get() 行为。这不是 bug，是设计使然：关联结果无法保证顺序稳定，也无法在服务端逐行流式返回。
典型陷阱：User::with('posts')->cursor() → 实际执行的是全量 JOIN 查询，内存占用可能是单表的 5–10 倍。
- 解决思路是“拆”：先用
cursor()拿主表 ID 流（select('id')），再按批次（如每次 500 个 ID）查关联数据，用whereIn('user_id', $ids) - 避免在游标循环里做 N+1 查询（比如 foreach 中调
$user->posts），这会让 DB 连接数暴涨、延迟飙升 - 如果必须强关联，考虑用原生 SQL + 游标变量（MySQL 8.0+ 支持
DECLARE cursor_name CURSOR FOR ...），绕过 ORM 层限制
真正决定内存是否暴增的，从来不是循环语法，而是数据何时、以何种结构进入 PHP 进程。游标有效性的边界，往往藏在 ORM 配置、查询构造方式和数据库驱动行为的交界处。
