Laravel controller trait for paginating models

v1.1.0 2017-11-07 03:03 UTC

This package is auto-updated.

Last update: 2020-08-28 14:21:35 UTC


Packagist Packagist

This trait adds a super duper handy method that will give you behaviour from requests slightly similar to what something like league/fractal gives you without all the setup and needing to create transformers.

Between this trait, and Eloquent Models' $casts and $hidden properties, starting a basic API with about as much control as some more heavyweight packages give you, will be really quick.


composer require ryanwinchester/laravel-paginates


Add it to your controller (or base controller, as shown):

// ...
use RyanWinchester\Paginates\PaginatesModels;

class Controller extends BaseController
    use AuthorizesRequests, DispatchesJobs, ValidatesRequests, PaginatesModels;

Then use it in your controller methods like so:

class ProductsController extends Controller
    public function index()
        $products = $this->paginate(Product::class);

        return response()->json($products);

Sometimes because of security or privacy, you may want to limit include relationships and/or columns. If that is the case, then be sure to include the parameters you want, making sure to exclude any user-supplied include parameters.

$products = $this->paginate(
    $request->except(['include', 'columns'])

Or, say you want to define some included relationships yourself:

$products = $this->paginate(
    $request->except(['include', 'columns'])

Or, even limit to specific columns:

$products = $this->paginate(
    Product::select(['id', 'price', 'in_stock']),

You can pass in any builder instance or a model class name.


  • page : page=3 the page number
  • perPage : perPage=10 amount to show per page
  • columns : columns=title,body,author limit to certain columns
  • include : include=categories,tags load relations
  • orderBy : orderBy=published|desc order the items by a column and direction

In action

Then you can go to your route and add some of these optional parameters to page and filter: url


Please try it out and give feedback.

Taylor thinks it's a good idea, so I mean what other reason do you need?