In other frameworks, pagination can be very painful. Lumen and Laravel makes it a breeze. Lumen can generate an intelligent "range" of links based on the current page. The generated HTML is compatible with the Bootstrap CSS framework.
Of course, if you are building a JSON API, the paginator will generate a useful JSON response, including URLs to the previous and next "page".
There are several ways to paginate items. The simplest is by using the paginate
method on the query builder or an Eloquent model.
$users = DB::table('users')->paginate(15);
Note: Currently, pagination operations that use a
groupBy
statement cannot be executed efficiently by Lumen and Laravel. If you need to use agroupBy
with a paginated result set, it is recommended that you query the database and create a paginator manually.
Sometimes you may wish to create a pagination instance manually, passing it an array of items. You may do so by creating either an Illuminate\Pagination\Paginator
or Illuminate\Pagination\LengthAwarePaginator
instance, depending on your needs.
You may also paginate Eloquent models:
$allUsers = User::paginate(15);
$someUsers = User::where('votes', '>', 100)->paginate(15);
The argument passed to the paginate
method is the number of items you wish to display per page. Once you have retrieved the results, you may simply return them from your route / controller. The results will automatically be converted to JSON.
You may also display the results in your view. Create the pagination links using the render
method:
<div class="container">
@foreach ($users as $user)
{{ $user->name }}
@endforeach
</div>
{!! $users->render() !!}
You may also access additional pagination information via the following methods on the paginator:
currentPage
lastPage
perPage
hasMorePages
url
nextPageUrl
total
count
If you do not need to inform the user how many "total" items you are paginating, you have the option of using the simplePaginate
method to perform a more efficient query. This is useful for larger datasets:
$someUsers = User::where('votes', '>', 100)->simplePaginate(15);
You may also customize the URI used by the paginator via the setPath
method:
$users = User::paginate();
$users->setPath('custom/url');
The example above will create URLs like the following: http://example.com/custom/url?page=2
You can add to the query string of pagination links using the appends
method on the Paginator:
$users->appends(['sort' => 'votes']);
This will generate URLs that look something like this:
http://example.com/something?page=2&sort=votes
If you wish to append a "hash fragment" to the paginator's URLs, you may use the fragment
method:
$users->fragment('foo');
This method call will generate URLs that look something like this:
http://example.com/something?page=2#foo
The Paginator
class implements the Illuminate\Contracts\Support\JsonableInterface
contract and exposes the toJson
method. You may also convert a Paginator
instance to JSON by returning it from a route. The JSON'd form of the instance will include some "meta" information such as total
, current_page
, and last_page
. The instance's data will be available via the data
key in the JSON array.