wake/pager

A lightweight PHP paginator.

Pager

A lightweight PHP paginator., _(*1)

Installation

Add in your composer.json with following require entry:, _(*2)

{
  "require": {
    "wake/pager": "*"
  }
}

or using composer:, _(*3)

$ composer require wake/pager:*

then run composer install or composer update., _(*4)

Usage: Pager

Use Pager without any ORM., _(*5)

Use Pager\Pager;

$pager = new Pager ();

$pager->total (1000) // 1000 data items
  ->page (13)        // Set current page to no.13
  ->paging ();

// First page: 1
echo $pager->pages->top;

// Last page (total pages): 67
echo $pager->pages->end;

// First page of page group: 8
echo $page->pages->first;

// Last page of page group: 17
echo $page->pages->last;

// Next page: 14
echo $page->pages->next;

// Next 10 page: 24
echo $page->pages->next10;

// Pages
foreach ($pager->pages as $page)
  echo $page . "<br />";

// Page url
foreach ($pager->pages as $page)
  echo $page->url . "<br />";

$pager->show ($show)

Set amount of items per page, default to 15., _(*6)

// Display 12 items on each page.
$pager->show (12);

$pager->total ($total)

Set total amount of items., _(*7)

// Set total amount of 100.
$pager->total (100);

$pager->size ($size)

Set amount of page list per page, default to 10., _(*8)

// Display 5 pages of page group on each page - `1 2 3 4 5`
$pager->size (5);

$pager->page ($page)

Set current page, default to 1., _(*9)

// Set current to page 3
$pager->page (3);

$pager->dynamic (), $pager->fixed ()

List pages of page group dynamically or fixed, default is dynamic., _(*10)

// List dynamically: `1 2 3 4 5` -> `2 3 4 5 6` -> `3 4 5 6 7`
$pager->dynamic ();

// List fixed: `1 2 3 4 5` -> `6 7 8 9 10`
$pager->fixed ();

$pager->url ($pattern)

Set url pattern or handler function, default is pattern (:num)., _(*11)

// /?page=3
$pager->url ('/?page=(:num)');

// /?p=3
$pager->url (function ($pageItem) {
  return '/?p=' . $pageItem->num;
});

$pager->paging ()

Calculate and build page items, must be called after all options are set., _(*12)

$pager->paging ();

Usage: Pages

Container of page items., _(*13)

Use Pager\Pager;

$pager = new Pager ();

$pager->total (1000) // 1000 data items
  ->page (13)        // current page is no.13
  ->paging ();

$pages = $pager->pages;

$pages->top

First page of all pages, generally is 1., _(*14)

$pages->end

Last page of all pages., _(*15)

$pages->first

First page of page group., _(*16)

$pages->last

Last page of page group., _(*17)

$pages->total

Total amount of pages., _(*18)

$pages->current, $pages->page

Current page., _(*19)

$pages->next

Next page., _(*20)

$pages->prev

Previous page., _(*21)

$pages->next*N

Next N page., _(*22)

// Next page
$pages->next;
$pages->next1;

// Next 5 page
$pages->next5;

$pages->prev*N

Previous N page., _(*23)

// Previous page
$pages->prev;
$pages->prev1;

// Previous 5 page
$pages->prev5;

Usage: Page item

Page item., _(*24)

Use Pager\Pager;

$pager = new Pager ();

$pager->total (1000) // 1000 data items
  ->page (13)        // current page is no.13
  ->paging ();

$item = $pager->pages->first;

$item, $item->num

Number of the page, $item could be use as string directly., _(*25)

echo $item;
echo $item->num;

$item->url ()

Url of the page., _(*26)

echo $item->url ();

Feedback

Please feel free to open an issue and let me know if there is any thoughts or questions :smiley:, _(*27)

License

Released under the MIT license, _(*28)