Какие знаешь способы пагинации?

Способы пагинации в веб-приложениях

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

1. OFFSET/LIMIT (классическая пагинация)

Самый распространённый метод, использующий SQL-операторы LIMIT и OFFSET.

SELECT * FROM products 
ORDER BY created_at DESC 
LIMIT 20 OFFSET 40; -- Страница 3 при 20 элементах на странице

Плюсы:

• Простота реализации
• Поддержка случайного доступа к любой странице
• Совместимость со всеми СУБД

Минусы:

• Проблемы с производительностью на больших OFFSET (БД всё равно читает и отбрасывает пропускаемые строки)
• Нестабильность при изменении данных между запросами (дублирование или пропуск записей)

2. Keyset Pagination (пагинация по ключу)

Также известна как курсорная пагинация или seek method. Вместо OFFSET используется фильтрация по значению последнего полученного элемента.

SELECT * FROM products 
WHERE id > 50  -- ID последнего элемента предыдущей страницы
ORDER BY id 
LIMIT 20;

Плюсы:

• Отличная производительность (использует индекс)
• Стабильность при изменении данных
• Предсказуемое потребление памяти

Минусы:

• Невозможность перехода на произвольную страницу
• Сложнее реализовать при сортировке по нескольким полям
• Требует уникального последовательного ключа

3. Page Token Pagination

Расширение keyset-подхода, где курсор шифруется и передаётся клиенту как непрозрачный токен.

// Генерация токена
$token = base64_encode(json_encode([
    'last_id' => 150,
    'sort_field' => 'created_at',
    'sort_value' => '2024-01-15 10:30:00'
]));

// Дешифровка и использование
$params = json_decode(base64_decode($token), true);
$query = "SELECT * FROM posts WHERE created_at < '{$params['sort_value']}' ORDER BY created_at DESC LIMIT 20";

4. Infinite Scroll (бесконечная прокрутка)

Фактически UX-паттерн, который технически реализуется через OFFSET или Keyset пагинацию с AJAX-подгрузкой.

// Клиентская часть
window.addEventListener('scroll', async () => {
    if (window.innerHeight + window.scrollY >= document.body.offsetHeight - 500) {
        const response = await fetch(`/api/items?last_id=${lastId}`);
        const data = await response.json();
        // Добавление новых элементов в DOM
    }
});

5. Seek Method для сложных сортировок

Когда нужна сортировка по нескольким не-unique полям:

SELECT * FROM products 
WHERE (price < 100) OR (price = 100 AND id > 500)
ORDER BY price DESC, id ASC 
LIMIT 20;

6. Параметризованная пагинация

Комбинированный подход, который я часто использую в REST API:

class Paginator
{
    public function paginate(
        Builder $query, 
        int $limit, 
        ?string $cursor = null,
        string $direction = 'next'
    ): PaginationResult {
        if ($cursor) {
            $cursorData = $this->decodeCursor($cursor);
            $query->where('id', $direction === 'next' ? '>' : '<', $cursorData['id']);
        }
        
        $items = $query->limit($limit + 1)->get(); // +1 для проверки has_more
        
        return new PaginationResult(
            items: $items->take($limit),
            nextCursor: $items->count() > $limit ? $this->createCursor($items[$limit - 1]) : null,
            hasMore: $items->count() > $limit
        );
    }
}

Критерии выбора метода

1. Размер данных: Для небольших наборов (~10K записей) подходит OFFSET, для больших — Keyset
2. Частота изменений: При частых writes необходим Keyset для избежания аномалий
3. Требования к UX: Нужен ли произвольный доступ к страницам или достаточно next/previous
4. Сортировка: Простые сортировки по первичному ключу vs. сложные multi-column сортировки

Оптимизации и лучшие практики

• Индексы: Все поля в WHERE и ORDER BY должны быть проиндексированы
• Размер страницы: Адаптивный лимит (20-100 записей), иногда с максимальным ограничением
• Мета-информация: Всегда возвращайте total, has_more, next_cursor в API
• Кэширование count(*) для OFFSET-пагинации при больших объемах
• Оптимистичная загрузка дополнительных записей для плавного скролла

Заключение

В современных приложениях я предпочитаю Keyset-пагинацию как наиболее производительный и стабильный вариант, особенно для API и лент данных. OFFSET оставляю для админ-панелей с небольшими наборами данных. Важно проектировать пагинацию как неотъемлемую часть архитектуры данных, а не добавлять её постфактум. Каждый метод имеет свою нишу применения, и опытный разработчик должен уметь выбирать оптимальный подход под конкретные требования проекта.