Skip to content

A package for consistent pagination, especially in API requests.

Notifications You must be signed in to change notification settings

joshbrw/laravel-pagination-specification

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Laravel Pagination Specification

The main purpose of this package is to provide a consistent object that represents all of the main values you have to take into account when paginating (i.e. Current Page, Per Page, Appends for the URLs).

This object can then be passed around to methods and used for less verbose method parameters.

Installing

  1. composer require joshbrw/laravel-pagination-specification
  2. Add the following Service Provider to your config/app.php under provider:
       Joshbrw\PaginationSpecification\PaginationSpecificationServiceProvider::class
  3. Optionally publish the config and change the default Per Page;
    php artisan vendor:publish --provider="Joshbrw\PaginationSpecification\PaginationSpecificationServiceProvider"

Usage

The class is bound into the container under the Joshbrw\PaginationSpecification\PaginationSpecification interface, and can be overwritten/decorated if required.

For example, injecting into a Controller method:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\View\View;
use Joshbrw\PaginationSpecification\PaginationSpecification;

class UserController extends Controller {
    public function index(
        Request $request,
        PaginationSpecification $paginationSpecification,
        UserRepository $userRepository
    ): View {
        // Reads the `per_page` and `page` values from the request
        $paginationSpecification->fromRequest($request);
        
        // Set how many items we want per page
        $paginationSpecification->setPerPage(30);
        
        // This can now be passed around to other methods, which can typehint it as a dependency
        return $userRepository->get($paginationSpecification);
    }
}

About

A package for consistent pagination, especially in API requests.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages