Пагинация на PHP: Полное руководство от теории до практики

Когда ваш сайт начинает обрастать контентом — статьями, товарами, комментариями — возникает необходимость разбивать информацию на страницы. Пагинация — это не просто удобство, а фундаментальный элемент юзабилити и производительности. В этом руководстве мы разберем, как реализовать умную, эффективную и красивую пагинацию на PHP, от базовых принципов до продвинутых техник.

Что такое пагинация и зачем она нужна?

Пагинация (или постраничная навигация) — это механизм разделения большого массива данных (например, результатов из базы данных) на отдельные, последовательные страницы. Представьте, что у вас 500 товаров в каталоге. Выводить их все сразу — плохая идея. Страница будет грузиться вечность, а пользователь утонет в информации. Пагинация решает эту проблему, предлагая удобную навигацию по «порциям» данных.

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

Основные компоненты системы пагинации

Любая система пагинации строится на трех китах:

Определение текущей страницы: Обычно через GET-параметр, например, ?page=2.
Расчет лимита и смещения (LIMIT и OFFSET) для SQL-запроса: Это сердце пагинации.
Генерация ссылок на страницы: Визуальный интерфейс для пользователя.

Практическая реализация: шаг за шагом

Шаг 1: Получаем параметры и настраиваем переменные

Сначала определим, какую страницу запросил пользователь, и установим базовые константы.

// Текущая страница. По умолчанию - первая.
$page = isset($_GET['page']) ? (int)$_GET['page'] : 1;
if ($page < 1) $page = 1;

// Количество записей на одной странице
$perPage = 10;

// Рассчитываем смещение (OFFSET) для SQL-запроса
$offset = ($page - 1) * $perPage;

Шаг 2: Запрос к базе данных с LIMIT и OFFSET

Теперь модифицируем наш SQL-запрос, чтобы получить только нужную «порцию» данных.

// Предположим, у нас есть подключение $pdo
$stmt = $pdo->prepare("SELECT * FROM articles ORDER BY created_at DESC LIMIT :limit OFFSET :offset");
$stmt->bindValue(':limit', $perPage, PDO::PARAM_INT);
$stmt->bindValue(':offset', $offset, PDO::PARAM_INT);
$stmt->execute();
$articles = $stmt->fetchAll();

Важно! Всегда используйте подготовленные выражения (prepared statements) для подстановки LIMIT и OFFSET, чтобы избежать SQL-инъекций. Не подставляйте значения напрямую в строку запроса.

Шаг 3: Узнаем общее количество записей

Чтобы построить навигацию, нам нужно знать, сколько всего страниц. Для этого выполняем отдельный запрос на подсчет строк.

$totalStmt = $pdo->query("SELECT COUNT(*) FROM articles");
$totalArticles = (int) $totalStmt->fetchColumn();

// Рассчитываем общее количество страниц
$totalPages = ceil($totalArticles / $perPage);

Шаг 4: Генерация ссылок пагинации

Создадим красивый блок со ссылками. Добавим логику для отображения только части страниц вокруг текущей.

if ($totalPages > 1) {
    echo '';
    // Кнопка "Назад"
    if ($page > 1) {
        echo '« Назад';
    }
    // Номера страниц
    for ($i = 1; $i <= $totalPages; $i++) {
        // Показываем только страницы в диапазоне +/-2 от текущей
        if ($i == 1 || $i == $totalPages || ($i >= $page - 2 && $i <= $page + 2)) {
            $active = ($i == $page) ? ' class="active"' : '';
            echo '' . $i . '';
        } elseif ($i == $page - 3 || $i == $page + 3) {
            echo '...'; // Многоточие для пропущенных страниц
        }
    }
    // Кнопка "Вперед"
    if ($page < $totalPages) {
        echo 'Вперед »';
    }
    echo '';
}

Продвинутые техники и оптимизация

Кеширование COUNT(*): Для очень больших таблиц подсчет общего количества записей может быть медленным. Рассмотрите возможность периодического сохранения этого значения в отдельной таблице или кеше (Redis, Memcached).
Бесконечная прокрутка (Infinite Scroll): Реализуется через AJAX. При скролле до низа страницы отправляется запрос на сервер за следующей «порцией» данных. Основная логика пагинации (LIMIT/OFFSET) остается той же.
Ключевой пагинатор (Keyset Pagination): Вместо OFFSET использует условие WHERE id > last_id. Идеально для очень больших и часто обновляемых наборов данных, так как не страдает от проблем производительности при больших смещениях.

FAQ: Часто задаваемые вопросы

Какой GET-параметр лучше использовать для номера страницы?

Чаще всего используют page или p. Важно быть последовательным по всему сайту. Не забудьте проверять и приводить значение к целому числу.

Почему пагинация важна для SEO?

Поисковые системы ограничивают «бюджет сканирования» (crawl budget) для каждого сайта. Если у вас одна гигантская страница со всеми данными, робот может не успеть ее просканировать полностью. Пагинация, особенно с правильно реализованными тегами rel="next" и rel="prev", помогает поисковикам понять структуру вашего контента.

Как избежать дублей контента при пагинации?

Используйте канонические теги (rel="canonical") на страницах пагинации, указывая на первую страницу или на страницу с полным списком (если она есть). Это сигнализирует поисковикам, какая страница является основной.

Что делать, если пользователь ввел несуществующий номер страницы?

Ваш код должен это обрабатывать. Если $page > $totalPages, можно перенаправить пользователя на последнюю существующую страницу (header('Location: ?page=' . $totalPages)) или показать сообщение «Страница не найдена» (404).