如何在Laravel 7中通过Eloquent为查询结果添加自增序号列

嘿，这个需求在分页场景下挺常见的，我给你几种不同的实现方案，你可以根据自己的实际场景来选：

方案1：通过Laravel集合添加序号（最灵活） #

如果只是需要在内存里给查询结果附加序号，用集合的map方法就很方便，还能轻松区分本地分页序号和全局连续序号：

本地分页序号（每页从1开始） #

适合只关心当前页内的序号排序：

// 先执行你的原查询
$forumPosts = ForumPost::getByForumThreadId($forum_thread_id)
    ->orderBy($order_by, $order_direction)
    ->offset($limit_start)
    ->take($forum_posts_per_page)
    ->get();

// 给集合添加序号字段
$forumPosts = $forumPosts->map(function ($post, $index) {
    // 给每个帖子对象新增serial_number属性
    $post->serial_number = $index + 1;
    return $post;
});

// PHP 7.4+ 可以用更简洁的箭头函数写法
$forumPosts = $forumPosts->map(fn($post, $index) => tap($post, fn($p) => $p->serial_number = $index + 1));

全局连续序号（跨页递增） #

如果需要序号跨页连续（比如第1页最后一条是15，第2页第一条直接从16开始），只需要结合你的$limit_start（偏移量）来计算：

$forumPosts = $forumPosts->map(function ($post, $index) use ($limit_start) {
    $post->serial_number = $limit_start + $index + 1;
    return $post;
});

// 箭头函数简化版
$forumPosts = $forumPosts->map(fn($post, $index) => tap($post, fn($p) => $p->serial_number = $limit_start + $index + 1));

方案2：直接在Blade视图中显示序号（最简便） #

如果只是要在前端页面展示序号，完全不需要修改集合，直接用Blade自带的$loop变量就行：

@foreach($forumPosts as $post)
    <div class="post-item">
        {{-- 本地分页序号 --}}
        <span class="serial-number">{{ $loop->index + 1 }}</span>
        {{-- 或者全局连续序号 --}}
        <span class="serial-number">{{ $limit_start + $loop->index + 1 }}</span>
        <h3>{{ $post->title }}</h3>
    </div>
@endforeach

$loop->index是从0开始的循环索引，加1就变成了从1开始的序号。

方案3：数据库层面添加序号（适合大数据量） #

如果你的数据量很大，不想在内存中处理集合，可以直接通过数据库语句生成序号，不同数据库的写法略有区别：

MySQL 8.0+/PostgreSQL/SQL Server（支持窗口函数） #

用ROW_NUMBER()窗口函数可以直接生成全局连续序号，优雅又高效：

$forumPosts = ForumPost::selectRaw('*, ROW_NUMBER() OVER (ORDER BY ? ?) as serial_number', [$order_by, $order_direction])
    ->where('forum_thread_id', $forum_thread_id)
    ->offset($limit_start)
    ->take($forum_posts_per_page)
    ->get();

注意：这里的ORDER BY参数通过绑定传入，能有效避免SQL注入。

MySQL 5.x（不支持窗口函数） #

可以用用户变量来实现序号自增：

$forumPosts = DB::select('
    SELECT *, @row := @row + 1 as serial_number
    FROM (
        SELECT * FROM forum_posts 
        WHERE forum_thread_id = ? 
        ORDER BY ? ?
    ) as posts,
    (SELECT @row := ?) as row_counter
    LIMIT ?, ?
', [
    $forum_thread_id,
    $order_by,
    $order_direction,
    $limit_start, // 初始序号值，等于已跳过的记录数
    $limit_start, // offset
    $forum_posts_per_page // take
]);

这种方式返回的是数组而非Eloquent模型，如果你需要模型对象，可以后续做一下转换。

总结 #

• 仅前端展示：优先用Blade的$loop变量，最省心。
• 业务逻辑需要用到序号：用集合map方法，灵活且保留Eloquent模型特性。
• 大数据量场景：用数据库层面的序号生成，减少内存消耗。

内容的提问来源于stack exchange，提问作者mstdmstd