Пагинация, которая не теряет фильтры

Пагинация, которая не теряет фильтрыстрока запроса в CodeIgniter 3 и pager в CodeIgniter 4

Поиск находит «чайник», а вторая страница показывает весь каталог. Разбираем, как сохранить GET-фильтры в ссылках пагинации в CodeIgniter 2, 3 и 4 и как обойтись с такими страницами для поиска.

Раздел
CodeIgniter
Стек
PHPCodeIgniter 3CodeIgniter 4
Уровень
Средний
Опубликовано
Обновлено
Чтение
8 мин
Коротко
  • В CI3 фильтры в ссылках сохраняет reuse_query_string.
  • count_all_results(..., FALSE) считает с теми же условиями.
  • В CI4 paginate() и $pager->only() решают задачу целиком.
  • Страницы 2+ ставят canonical на себя, лишние номера дают 404.
Как решаем
  1. Перенесите номер страницы в строку запроса
  2. Включите reuse_query_string в CI3 или only() в CI4
  3. Считайте записи с теми же условиями, что и выборку
  4. Отдавайте 404 для номеров за пределами выдачи
  5. Ставьте самоканонический canonical на каждой странице

Где ломается пагинация с фильтрами#

Типичный каталог: список товаров, поле поиска и выбор сортировки, всё передаётся через GET, чтобы ссылку на выдачу можно было скопировать. Пока страниц одна, всё хорошо. Как только включается пагинация, оказывается, что ссылка «Следующая» ведёт на /products/2 или ?page=2 и теряет q и sort: пользователь искал «чайник», а на второй странице видит весь каталог.

Библиотека Pagination в CodeIgniter строит ссылки из того, что ей передали в конфиг, и про текущую строку запроса до третьей версии не знала. Поэтому задача решается по-разному в зависимости от версии фреймворка. Ниже разбираем CodeIgniter 2 и 3, а затем современный вариант на CodeIgniter 4 и вопрос, который всегда всплывает следом: что делать с такими страницами для поиска.

Сегмент URL или строка запроса#

По умолчанию номер страницы живёт в сегменте URI: /products/index/40. Параметр uri_segment (по умолчанию 3) говорит библиотеке, в каком сегменте его искать, а в сегменте по умолчанию лежит смещение записи, а не номер страницы. С фильтрами в GET такой формат неудобен: часть состояния в пути, часть в строке запроса, и их легко рассинхронизировать.

Флаг page_query_string переносит номер в строку запроса, имя параметра задаёт query_string_segment (по умолчанию per_page). Вместе с use_page_numbers адрес становится понятным: /products?q=чайник&page=2.

В CodeIgniter 2 библиотека просто дописывала к base_url кусок &per_page=N, поэтому фильтры приходилось собирать в base_url самостоятельно, и он обязан был уже содержать знак вопроса:

PHP
<?php
// CodeIgniter 2: фильтры приходилось вшивать в base_url вручную
$filters = array_filter(array(
    'q'    => $this->input->get('q', TRUE),
    'sort' => $this->input->get('sort', TRUE),
));

$config['base_url']          = site_url('products') . '?' . http_build_query($filters);
$config['page_query_string'] = TRUE;   // библиотека допишет &per_page=N

Работало, но каждое новое поле фильтра приходилось не забыть добавить в этот массив.

CodeIgniter 3: reuse_query_string#

В третьей версии появилась опция reuse_query_string: библиотека берёт текущий $_GET, убирает из него собственный параметр страницы и добавляет остальное к каждой ссылке. Полный пример контроллера с поиском, подсчётом и разметкой:

PHP
<?php
// application/controllers/Products.php (CodeIgniter 3)
public function index()
{
    $this->load->library('pagination');

    $q        = trim((string) $this->input->get('q', TRUE));
    $per_page = 20;
    $page     = max(1, (int) $this->input->get('page'));

    if ($q !== '') {
        $this->db->like('name', $q);
    }
    // FALSE: не сбрасывать условия, они нужны для выборки ниже
    $total = $this->db->count_all_results('products', FALSE);

    $rows = $this->db
        ->order_by('name')
        ->limit($per_page, ($page - 1) * $per_page)
        ->get()
        ->result();

    $this->pagination->initialize(array(
        'base_url'             => site_url('products'),
        'total_rows'           => $total,
        'per_page'             => $per_page,
        'page_query_string'    => TRUE,
        'query_string_segment' => 'page',
        'use_page_numbers'     => TRUE,
        'reuse_query_string'   => TRUE,   // сохранить ?q=... в ссылках
        'full_tag_open'        => '<nav aria-label="Страницы"><ul class="pager">',
        'full_tag_close'       => '</ul></nav>',
        'num_tag_open'         => '<li>',
        'num_tag_close'        => '</li>',
        'cur_tag_open'         => '<li><span aria-current="page">',
        'cur_tag_close'        => '</span></li>',
        'next_tag_open'        => '<li>',
        'next_tag_close'       => '</li>',
        'prev_tag_open'        => '<li>',
        'prev_tag_close'       => '</li>',
    ));

    $this->load->view('products/index', array(
        'rows'  => $rows,
        'q'     => $q,
        'links' => $this->pagination->create_links(),
    ));
}

На что обратить внимание:

  • Подсчёт и выборка с одними условиями. Второй аргумент FALSE у count_all_results() не сбрасывает построитель запроса, и like() применяется к обоим запросам. Без него число страниц считается по всему каталогу.
  • Смещение. С use_page_numbers в параметре лежит номер страницы, смещение для limit() считаем сами.
  • Разметка. Пары full_tag_open/full_tag_close, cur_tag_open и соседние задают HTML вокруг ссылок. Это удобное место, чтобы добавить nav с подписью и aria-current для текущей страницы.
  • Безопасность. Значение q из запроса передаётся в like(), который экранирует его сам. Если пишете SQL руками, используйте привязку параметров, как в заметке про подготовленные выражения PDO.

CodeIgniter 4: paginate() и pager#

В четвёртой версии пагинация встроена в модель. Метод paginate() сам читает номер страницы из параметра page, считает общее число записей с учётом уже наложенных условий, делает выборку с нужным смещением и сохраняет объект пейджера в $model->pager.

PHP
<?php
// app/Controllers/Products.php (CodeIgniter 4)
namespace App\Controllers;

use App\Models\ProductModel;
use CodeIgniter\Exceptions\PageNotFoundException;

class Products extends BaseController
{
    public function index()
    {
        $q    = trim((string) $this->request->getGet('q'));
        $sort = $this->request->getGet('sort') === 'price' ? 'price' : 'name';

        $model = model(ProductModel::class);
        if ($q !== '') {
            $model->like('name', $q);
        }

        $rows  = $model->orderBy($sort)->paginate(20);
        $pager = $model->pager;

        // ?page=999 не должна отдавать пустую страницу с кодом 200
        if ($pager->getCurrentPage() > max(1, $pager->getPageCount())) {
            throw PageNotFoundException::forPageNotFound();
        }

        return view('products/index', [
            'rows'  => $rows,
            'pager' => $pager,
            'q'     => $q,
            'sort'  => $sort,
        ]);
    }
}

В представлении ссылки выводит $pager->links(). Пейджер CodeIgniter 4 по умолчанию сохраняет в ссылках все параметры текущей строки запроса. Удобно, но опасно: туда попадут и мусорные метки вроде utm_source, плодя варианты адресов. Метод only() ограничивает список явно:

PHP
<?php // app/Views/products/index.php (фрагмент) ?>
<form method="get" action="<?= site_url('products') ?>">
    <label for="q">Поиск</label>
    <input id="q" name="q" value="<?= esc($q) ?>">
    <button>Найти</button>
</form>

<!-- в ссылки страниц попадут только q и sort -->
<?= $pager->only(['q', 'sort'])->links() ?>

Разметку ссылок задают шаблоны в Config\Pager::$templates: можно зарегистрировать своё представление и передать его имя вторым аргументом links(). Если на странице два независимых списка, у каждого своя группа: paginate(20, 'news') и $pager->links('news'), а номер страницы группы будет в параметре page_news.

Не всякая выборка удобно ложится в модель. Если данные приходят из сложного запроса с группировкой или из внешнего API, пейджер можно получить как сервис: service('pager')->makeLinks($page, $perPage, $total) вернёт готовую разметку ссылок, а смещение и подсчёт вы делаете сами. Для бесконечных лент и мобильной вёрстки есть короткий вариант simpleLinks(), который выводит только «Назад» и «Вперёд» без номеров. Он заметно легче на узких экранах, но лишает пользователя возможности перепрыгнуть сразу на нужную страницу, поэтому для каталогов с сотнями позиций мы оставляем полный вариант.

Что изменилось к 2026 году#

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

ВопросБыло принятоСейчас
rel="prev" и rel="next"Обязательная разметка серииGoogle объявил в 2019 году, что не использует её для индексации; вреда нет, но и опоры тоже
canonical на страницах 2+На первую страницуНа саму себя: ?page=3 указывает на ?page=3, иначе товары с дальних страниц теряют путь для обхода
noindex на страницах 2+Часто ставилиСпорно: ссылки с таких страниц со временем могут перестать учитываться, решайте по конкретному каталогу
Сортировка и фильтрыИндексировали всёКанонический адрес без параметров сортировки, комбинации фильтров только осознанно
Несуществующая страницаПустой список и 200404, как в примере контроллера выше

Ветки 2.x и 3.x давно не получают обновлений безопасности, так что новый каталог стоит писать на CodeIgniter 4 с PHP 8. При переносе не копируйте массив настроек: почти все его ключи заменяются одним вызовом paginate() и шаблоном пейджера. Если адреса каталога меняются, настройте редиректы со старых, а заодно уберите из них лишнее, об этом заметки про удаление index.php и про дефисы в URL.

Проверочный список перед выкладкой#

  1. Откройте выдачу с фильтром, перейдите на вторую и последнюю страницы: фильтр должен сохраниться в каждой ссылке.
  2. Поменяйте фильтр на второй странице: форма должна сбросить номер страницы, иначе пользователь попадёт на пустую страницу новой выборки. Для этого в форме просто не передавайте page.
  3. Запросите заведомо большой номер страницы и убедитесь, что ответ 404, а не пустой список.
  4. Посмотрите исходный код: canonical и ссылки пагинации не должны содержать utm_ и другие посторонние параметры.
  5. Пройдите пагинацию клавиатурой: ссылки достижимы по Tab, текущая страница отмечена aria-current.

Ещё больше практических заметок по фреймворку в разделе CodeIgniter.

3uri_segment по умолчанию в CI3
pageпараметр страницы в CodeIgniter 4
2019Google перестал опираться на rel=next/prev

«Номер страницы и фильтры это одно состояние выдачи; ссылка, которая теряет половину, ведёт в другой каталог.»

Главный вывод заметки

Вопросы и ответы

Вопросы и ответы

Почему на второй странице пропадает фильтр поиска?
Библиотека пагинации строит ссылки из base_url и номера страницы. Если ей не сказать про текущие GET-параметры, они теряются. В CodeIgniter 3 включите reuse_query_string, в CodeIgniter 2 соберите фильтры в base_url, в CodeIgniter 4 параметры сохраняются сами.
Число страниц не совпадает с найденными записями, в чём дело?
Подсчёт выполнен без условий фильтра. В CodeIgniter 3 вызов count_all_results сбрасывает построитель запроса, если не передать вторым аргументом FALSE. Тогда like и where применятся и к подсчёту, и к выборке, и число страниц сойдётся.
Как в CodeIgniter 4 не тащить utm-метки в ссылки пагинации?
Вызовите $pager->only() со списком нужных параметров перед links(), например only(['q', 'sort']). В ссылки страниц попадут только они, а метки и случайные параметры останутся за бортом и не будут плодить дубли адресов.
Закрывать ли страницы пагинации от индексации?
Однозначного ответа нет. Чаще разумно оставить страницы открытыми с canonical на самих себя, чтобы поисковик находил товары с дальних страниц. Noindex имеет смысл для комбинаций сортировки и фильтров, которые не несут отдельной ценности.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

Читайте также