LazyCollection 是什么，怎么省内存？
lazycollection 是 thinkorm 4.0 提供的延迟加载集合类，核心作用是避免一次性将数据库查询结果全部加载到内存中。它通过迭代器模式，在遍历数据时按需从数据库获取单条或分批记录，从而在处理百万级大数据量时显著降低内存占用。
use think\db\Query;
// 假设有一个包含大量数据的表
$query = Db::name('user');
// 使用 lazy 方法获取 LazyCollection 实例
$collection = $query->lazy(100); // 每次从数据库读取 100 条
foreach ($collection as $user) {
// 处理单条数据
echo $user['id'] . PHP_EOL;
// 处理完后，该条数据占用的内存会被释放（取决于 PHP GC）
}
上述代码中，lazy(100) 参数指定了每次从数据库游标中拉取的记录数。默认情况下，如果不传参，ThinkORM 可能会尝试一次性加载所有结果，导致 Memory Limit Exceeded。通过设置批次大小，程序只保留当前批次的数据在内存中，遍历完即丢弃，从而实现流式处理。
如何结合业务逻辑进行高效处理？
在实际业务中，通常需要对数据进行过滤、转换或聚合操作。LazyCollection 支持链式调用，但需要注意某些操作会触发立即执行。为了保持低内存特性，应优先使用惰性操作方法，如 map、filter 等，并确保最终通过 foreach 触发迭代。
$collection = Db::name('order')
->where('status', 'completed')
->field('id, amount, create_time')
->lazy(50);
$totalAmount = 0;
$count = 0;
foreach ($collection as $order) {
// 可以在这里进行复杂计算，不会累积大量对象
if ($order['amount'] > 1000) {
$totalAmount += $order['amount'];
$count++;
}
}
echo "Total: $totalAmount, Count: $count";
在这个例子中，where 和 field 只是构建查询条件，并不会立即执行 SQL。只有当进入 foreach 循环时，才会根据 lazy(50) 的设置分批查询数据库。这样即使有数百万条订单，内存中也始终只存在约 50 个订单对象，极大地节省了资源。
LazyCollection 在遍历过程中如何处理异常和中断？
在使用 LazyCollection 时，如果在遍历过程中发生异常或需要提前终止，需要特别注意资源的释放。虽然 PHP 的垃圾回收机制会在脚本结束或变量被覆盖时自动清理内存，但在长时间运行的任务中，显式控制或确保迭代器正确关闭有助于防止连接泄漏。
try {
$collection = Db::name('log')->lazy(1000);
foreach ($collection as $log) {
// 模拟处理逻辑
processLog($log);
// 如果满足条件，可以 break 提前退出
if ($log['level'] === 'ERROR') {
break;
}
}
} catch (\Exception $e) {
// 异常处理
logError($e->getMessage());
}
当使用 break 跳出循环时，底层的数据库游标通常会被关闭，因为迭代器不再被消费。然而，如果是在更复杂的异步环境或长生命周期进程中，建议检查框架是否提供了明确的 close() 方法或类似机制来确保数据库连接及时归还给连接池。对于大多数 Web 请求场景，PHP 脚本执行完毕后连接会自动释放，因此主要关注点仍在于内存峰值的控制。
