Laravel ChunkById

What is chunkById

分批把资料从资料库中拉出来，而非一次全拉。

以订单为例，使用范例如下：

use App\Models\Order;

$num_per_chunk = 500; // 每次拉 500 个
$column_as_id = 'order_id'; // 不给这个参数的话预设是会用主键(primary key)

Order::where('status', '>', 0)->chunkById($num_per_chunk, function($orders){
    // 自己比较常遇到需要在搭配 foreach 对每个物件作操作
    foreach ($orders as $order) {
        // 看要对每笔订单做什麽
    }
}, $column_as_id);

Why chunkById

那为什麽不直接 get() 再 foreach 就好，还要多这一层？

$orders = Order::where('status', '>', 0)->get();// 直接 get!

if (!is_null($orders)) {
    foreach ($orders as $order) {
        // 看要对每笔订单做什麽
    }
}

最直接的原因是这样会一次把资料都载入记忆体，资料量如果很大，记忆体会不够用。

chunk vs. chunkById

这两个都是 Laravel 提供的 chunk 的方法，主要差别在於，如果资料捞出来是要更新再写回资料库，而非单纯读取，建议用 chunkById，不然每一次(chunk)更新後可能会影响下一次的捞取。

下面这个例子就是一边更新一边捞取，无穷回圈。

Post::where('updated_at', '<', now())->chunk(1000, function ($post) {
    $post->update('updated_at', now());
});

Reference

• 官方文件
• Differences between larravel eloquent chunk() and chunkybyid()