PHP cursor 常见问题有哪些？避坑指南请收好！

发布日期： 2025-09-26 阅读量： 作者： admin

我的 PHP Cursor 实践记录

最近在工作中碰到了一个挺头疼的问题。有个功能需要处理一大批数据，是从数据库里捞出来的。一开始没多想，就直接用老办法，一把 `fetchAll` 全抓出来，想着放内存里处理方便。

好家伙，测试环境数据少，跑得挺欢。一到线上，数据量猛增到几百万条，我的 PHP 脚本直接就给我表演了一个原地爆炸，内存“哗”一下就满了，错误日志里全是 `Allowed memory size exhausted`。当时我就懵了，这可咋整？总不能让运维天天给我加内存，那也不是个事儿。

没办法，只能硬着头皮找解决方案。我就琢磨，能不能不一次性把所有数据都读到内存里？就像流水线一样，处理完一条再来下一条。顺着这个思路，我到处翻资料，问了问群里的老哥，有人就提到了“游标（Cursor）”这个东西。

听起来好像挺靠谱。我就去查了查 PHP 里怎么用这玩意儿。发现 PDO 好像就支持类似的操作。它允许你在执行查询后，不立即把所有结果集都取回到 PHP 内存，而是可以一条一条地去遍历。这不就是我想要的吗？

说干就干，我赶紧把代码改了改。大概思路就是，先 `prepare` 然后 `execute`，接着不用 `fetchAll` 了，而是直接用 `foreach` 循环遍历那个 `PDOStatement` 对象。

php

// 伪代码示意下

$pdo = new PDO(...);

$sql = "SELECT id, name FROM large_table WHERE condition = ?";

$stmt = $pdo->prepare($sql);

$stmt->execute([$some_value]);

// 关键就在这，直接遍历 $stmt

foreach ($stmt as $row) {

// 在这里处理每一行数据 $row

// 比如 $row['id'], $row['name']

// 这里内存占用就小多了

process_data($row);

// 理论上循环结束，资源就释放了

改完之后，赶紧部署到测试环境试试。效果立竿见影！之前跑一会儿就挂的脚本，现在稳稳当当地跑完了，内存占用一直维持在一个很低的水平。看着监控图上平稳的内存曲线，心里那叫一个舒坦。

高兴之余也发现点需要注意的地方。特别是用 MySQL 的时候，默认情况下，PDO 可能还是会尝试把结果集缓冲到 PHP 这一端（这取决于 PDO 驱动和设置）。如果你真的想让数据库服务器那边一行一行地发数据过来，实现真正的“流式”处理，可能需要特别设置一下连接属性。

我当时就遇到了这个情况，感觉内存虽然没爆，但好像也没想象中那么低。后来查了下，对于 MySQL，可以设置 `PDO::MYSQL_ATTR_USE_BUFFERED_QUERY` 为 `false`。像这样：

php

$pdo = new PDO('mysql:host=...', 'user', 'pass', [

PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => false,

// 然后再执行查询和遍历

设置成 `false` 之后，感觉效果更明显了，内存占用更加稳定。这就告诉我们，光知道用 `foreach` 遍历还不够，还得了解底层的一些机制和驱动的特性，才能把工具用得更到位。

这回实践让我深刻体会到，处理大数据量时，不能想当然地一把梭哈。利用数据库游标（或者 PDO 这种模拟游标的方式），逐行处理数据，是避免内存耗尽、保证程序稳定性的一个非常有效的手段。

虽然过程中也踩了点小坑，比如对缓冲查询的理解不够深入，但最终解决了问题，也学到了新知识，感觉还是挺值的。以后再遇到类似场景，心里就有底了。