Laravel：如何扩展默认分页器添加项编号并重构重复代码？

Got it, let's fix this pagination numbering problem in a clean, maintainable way—no repeated code, no messy view logic. Here are two solid approaches that keep your backend logic where it belongs:

1. Extend LengthAwarePaginator with a Macro (My Favorite) #

Since your pagination context (current page, per-page count) lives in the paginator instance, adding a macro directly to LengthAwarePaginator makes perfect sense. This way every paginated result set can use the numbering logic without repeating code.

First, register the macro in your AppServiceProvider's boot() method:

use Illuminate\Pagination\LengthAwarePaginator;

public function boot()
{
    LengthAwarePaginator::macro('itemNumber', function ($index) {
        // Calculate 1-based number using paginator's context
        return ($this->currentPage() - 1) * $this->perPage() + $index + 1;
    });
}

Then in your controller, just use regular pagination like normal:

$items = YourModel::paginate(15); // Or whatever per-page count you want
return view('your.view', compact('items'));

In your view, call the macro directly on the paginator, passing the loop index:

<table>
    @foreach($items as $index => $item)
        <tr>
            <td>{{ $items->itemNumber($index) }}</td>
            <!-- Your other columns here -->
        </tr>
    @endforeach
</table>

2. Add a Reusable Helper to Attach Numbers to Paginator Items #

If you prefer attaching the number directly to each model/collection item (so you can reference it as a property), create a reusable helper function.

First, make a helper file (e.g., app/Helpers/PaginationHelpers.php) and add this:

<?php

function addItemNumbersToPaginator($paginator)
{
    $updatedCollection = $paginator->getCollection()->transform(function ($item, $index) use ($paginator) {
        $item->item_number = ($paginator->currentPage() - 1) * $paginator->perPage() + $index + 1;
        return $item;
    });

    $paginator->setCollection($updatedCollection);
    return $paginator;
}

Don't forget to autoload helpers in your composer.json if you haven't already:

"autoload": {
    "files": [
        "app/Helpers/PaginationHelpers.php"
    ]
}

Then in your controller, it's a one-liner:

$items = addItemNumbersToPaginator(YourModel::paginate(15));
return view('your.view', compact('items'));

Now in your view, just use the attached property:

<td>{{ $item->item_number }}</td>

Why Your Previous Attempt Didn't Work #

You mentioned trying to add a macro to Support\Collection—the issue here is that the Collection itself doesn't have access to pagination context (current page, per-page count). That data is stored in the LengthAwarePaginator instance, so tying your numbering logic to the paginator (either via macro or passing the paginator to your collection transformation) is the key to making it work.

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