Создание постраничной навигации на языке PHP

Как вывести только первую страницу данных без возможности переключения?

Этот вариант подходит для случаев, когда требуется отобразить только свежие записи, не предоставляя навигацию (например, лента новостей на главной). Он реализуется простым запросом с LIMIT и без вычисления общего количества.

<?php
$perPage = 10;
$stmt = $db->prepare("SELECT * FROM articles ORDER BY created_at DESC LIMIT :limit");
$stmt->bindValue(':limit', $perPage, PDO::PARAM_INT);
$stmt->execute();
$rows = $stmt->fetchAll();
?>

Цель: быстрое получение небольшого набора данных без нагрузки на подсчёт общего числа строк. Случаи использования: блоки «Последние новости», «Популярные статьи» на главной странице, API с пагинацией «показать ещё».

Как отобразить список номеров страниц с возможностью перехода?

Классическая постраничная навигация с нумерованными ссылками. Реализация полностью совпадает с основным решением из rbase, но с добавлением логики для компактного отображения при большом количестве страниц (например, вывод только нескольких соседних номеров).

<?php
$range = 5;
$start = max(1, $page - $range);
$end = min($totalPages, $page + $range);
?>
<div class="pagination">
  <?php if($page > 1): ?>
    <a href="?page=1">Первая</a>
    <a href="?page=<?=$page-1?>">Назад</a>
  <?php endif; ?>
  <?php for($i=$start; $i<=$end; $i++): ?>
    <a href="?page=<?=$i?>" <?= $i==$page ? 'class="active"' : '' ?>><?=$i?></a>
  <?php endfor; ?>
  <?php if($page < $totalPages): ?>
    <a href="?page=<?=$page+1?>">Вперед</a>
    <a href="?page=<?=$totalPages?>">Последняя</a>
  <?php endif; ?>
</div>

Цель: быстрая навигация по страницам, особенно для больших списков. Случаи: каталог товаров, список пользователей, архив статей.

Как реализовать навигацию только с двумя кнопками (предыдущая/следующая)?

Минималистичный вариант для линейного перебора записей. Не требует отображения номеров, подходит для лент с бесконечной прокруткой или для простых списков.

<div class="pagination-simple">
  <?php if($page > 1): ?>
    <a href="?page=<?=$page-1?>">&laquo; Предыдущая</a>
  <?php endif; ?>
  <?php if($page < $totalPages): ?>
    <a href="?page=<?=$page+1?>">Следующая &raquo;</a>
  <?php endif; ?>
</div>

Цель: простота реализации и пользовательского интерфейса. Случаи: блоги, фотоальбомы, где важна последовательность, а не быстрый переход к середине.

Как загружать следующую страницу без перезагрузки страницы (AJAX)?

Современный подход для динамических интерфейсов. PHP-скрипт отдаёт только данные (JSON или HTML-фрагмент), а клиентский JavaScript подгружает их и вставляет в DOM.

// PHP-скрипт (ajax.php)
$page = isset($_GET['page']) ? (int)$_GET['page'] : 1;
// ... получение данных как в rbase ...
// Возвращаем JSON с записями и информацией о пагинации
echo json_encode([
  'items' => $rows,
  'currentPage' => $page,
  'totalPages' => $totalPages
]);

// JavaScript (fetch)
fetch('ajax.php?page=2')
  .then(response => response.json())
  .then(data => {
    // обновление списка и кнопок навигации
  });

Цель: плавное перелистывание без полной перезагрузки, улучшение пользовательского опыта. Случаи: интернет-магазины, ленты социальных сетей, панели управления.

Как организовать пагинацию с помощью готового компонента (например, Zend\Paginator)?

Готовые библиотеки предоставляют абстракцию для подсчёта записей, работы с различными адаптерами (массивы, БД) и генерации разметки. Это уменьшает количество шаблонного кода.

use Zend\Paginator\Paginator;
use Zend\Paginator\Adapter\ArrayAdapter;

$data = [/* большой массив */];
$paginator = new Paginator(new ArrayAdapter($data));
$paginator->setCurrentPageNumber($page);
$paginator->setItemCountPerPage($perPage);

foreach ($paginator as $item) {
  // вывод элемента
}
// генерация ссылок через вызов методов Paginator

Цель: ускорение разработки, стандартизация пагинации в проекте. Случаи: крупные фреймворки (Laravel, Symfony имеют свои встроенные решения), проекты, требующие множества различных пагинаторов.