PaginatesModels

, _(*1)

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., _(*2)

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., _(*3)

Install

composer require ryanwinchester/laravel-paginates

Usage

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

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

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

Then use it in your controller methods like so:, _(*5)

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., _(*6)

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

Or, say you want to define some included relationships yourself:, _(*7)

$products = $this->paginate(
    Product::with('variations'),
    $request->except(['include', 'columns'])
);

Or, even limit to specific columns:, _(*8)

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

You can pass in any builder instance or a model class name., _(*9)

Parameters:

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