Пагинация, которая не теряет фильтрыстрока запроса в 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.
- Перенесите номер страницы в строку запроса
- Включите reuse_query_string в CI3 или only() в CI4
- Считайте записи с теми же условиями, что и выборку
- Отдавайте 404 для номеров за пределами выдачи
- Ставьте самоканонический 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
// 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
// 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
// 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 // 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+ | Часто ставили | Спорно: ссылки с таких страниц со временем могут перестать учитываться, решайте по конкретному каталогу |
| Сортировка и фильтры | Индексировали всё | Канонический адрес без параметров сортировки, комбинации фильтров только осознанно |
| Несуществующая страница | Пустой список и 200 | 404, как в примере контроллера выше |
Ветки 2.x и 3.x давно не получают обновлений безопасности, так что новый каталог стоит писать на CodeIgniter 4 с PHP 8. При переносе не копируйте массив настроек: почти все его ключи заменяются одним вызовом paginate() и шаблоном пейджера. Если адреса каталога меняются, настройте редиректы со старых, а заодно уберите из них лишнее, об этом заметки про удаление index.php и про дефисы в URL.
Проверочный список перед выкладкой#
- Откройте выдачу с фильтром, перейдите на вторую и последнюю страницы: фильтр должен сохраниться в каждой ссылке.
- Поменяйте фильтр на второй странице: форма должна сбросить номер страницы, иначе пользователь попадёт на пустую страницу новой выборки. Для этого в форме просто не передавайте
page. - Запросите заведомо большой номер страницы и убедитесь, что ответ 404, а не пустой список.
- Посмотрите исходный код: canonical и ссылки пагинации не должны содержать
utm_и другие посторонние параметры. - Пройдите пагинацию клавиатурой: ссылки достижимы по Tab, текущая страница отмечена
aria-current.
Ещё больше практических заметок по фреймворку в разделе CodeIgniter.
«Номер страницы и фильтры это одно состояние выдачи; ссылка, которая теряет половину, ведёт в другой каталог.»
Главный вывод заметки


