Paginator

Veri listesini sayfalamanız mı gerekiyor? Sayfalama matematiği yanıltıcı olabileceğinden, Nette\Utils\Paginator size yardımcı olacaktır.

Kurulum:

composer require nette/utils

Bir sayfalayıcı nesnesi oluşturalım ve temel bilgileri ayarlayalım:

$paginator = new Nette\Utils\Paginator;
$paginator->setPage(1); // mevcut sayfa numarası
$paginator->setItemsPerPage(30); // sayfa başına öğe sayısı
$paginator->setItemCount(356); // toplam öğe sayısı (biliniyorsa)

Sayfalar 1'den başlar. Bunu setBase() kullanarak değiştirebiliriz:

$paginator->setBase(0); // 0'dan numaralandırıyoruz

Nesne şimdi sayfalayıcı oluştururken yararlı olan tüm temel bilgileri sağlayacaktır. Örneğin, onu bir şablona aktarabilir ve orada kullanabilirsiniz.

$paginator->isFirst(); // ilk sayfada mıyız?
$paginator->isLast(); // son sayfada mıyız?
$paginator->getPage(); // mevcut sayfa numarası
$paginator->getFirstPage(); // ilk sayfa numarası
$paginator->getLastPage(); // son sayfa numarası
$paginator->getFirstItemOnPage(); // sayfadaki ilk öğenin sıra numarası
$paginator->getLastItemOnPage(); // sayfadaki son öğenin sıra numarası
$paginator->getPageIndex(); // 0'dan başlayan mevcut sayfa numarası
$paginator->getPageCount(); // toplam sayfa sayısı
$paginator->getItemsPerPage(); // sayfa başına öğe sayısı
$paginator->getItemCount(); // toplam öğe sayısı (biliniyorsa)

Sayfalayıcı, SQL sorgusu oluştururken yardımcı olur. getLength() ve getOffset() metotları, LIMIT ve OFFSET yan tümcelerinde kullanacağımız değerleri döndürür:

$result = $database->query(
	'SELECT * FROM items LIMIT ? OFFSET ?',
	$paginator->getLength(),
	$paginator->getOffset(),
);

Ters sırada sayfalamamız gerekiyorsa, yani sayfa no. 1 en yüksek ofsete karşılık geliyorsa, getCountdownOffset() kullanırız:

$result = $database->query(
	'SELECT * FROM items LIMIT ? OFFSET ?',
	$paginator->getLength(),
	$paginator->getCountdownOffset(),
);

Uygulamada kullanım örneğini Veritabanı sonuçlarını sayfalama tarifinde bulabilirsiniz.