codeigniter 不内置也不支持 pagerjs,所谓“集成”实为混淆;可用方案包括pagejs(需api对接)、原生pagination类(服务端渲染)或bootstrap+ajax手动实现,关键在uri_segment与路由结构严格匹配。

CodeIgniter 本身不内置 PagerJS,也没有官方支持的 PagerJS 插件——这个名字是混淆项。你实际想用的,很可能是前端分页库(如 PageJS)配合 CodeIgniter 后端做「无刷新分页」,但必须明确:CodeIgniter 的原生分页类(Pagination)是服务端渲染的,和前端 JS 分页属于两种技术路线,不能混用配置、不能直接“集成 PagerJS”。
为什么 PagerJS 在 CodeIgniter 项目里根本不存在
搜索全网及 CodeIgniter 官方文档、GitHub 仓库、Packagist、主流插件平台,均无名为 PagerJS 的成熟、维护中、与 CodeIgniter 绑定的分页插件。你看到的标题大概率是误写或营销包装,真实可用的是:
-
PageJS(独立轻量 JS 库,无依赖,需手动对接后端 API) - CodeIgniter 原生
Pagination类(纯 PHP 服务端生成 HTML) - Bootstrap Pagination + AJAX 手动实现(常见折中方案)
PageJS 能用,但必须脱离 CodeIgniter 分页类单独工作
如果你坚持用前端 JS 分页(比如 PageJS),就得放弃 $this->pagination->create_links(),改走 API 路线:
- 后端控制器需提供 JSON 接口,例如
/api/articles?page=2&per_page=10,返回分页数据 + 总数 - 前端初始化
PageJS时,totalPages必须由接口响应动态计算:Math.ceil(total_rows / per_page) -
PageJS的onPageChange回调里要手动发 AJAX 请求,再更新列表 DOM,它不会自动读取 CodeIgniter 的uri_segment或配置 - URL 不再是
/articles/page/3,而是靠 History API 或 hash 模拟,SEO 和直连能力变弱
uri_segment 配错是 CodeIgniter 分页失效最常见原因
很多开发者照抄示例写 $config['uri_segment'] = 3,结果点链接没反应——因为实际 URL 结构不匹配。例如:
- 路由为
$route['article/(:num)'] = 'article/index/$1';,访问/article/5,页码在第 2 段 → 应设uri_segment = 2 - 使用
site_url('blog/listing')生成 base_url,但控制器方法签名是public function listing($page = 1),页码实为函数参数 →uri_segment应设为 0,且需启用$config['use_page_numbers'] = TRUE - 开启查询字符串模式(
$config['page_query_string'] = TRUE)后,uri_segment就失效了,页码从$_GET['per_page']读,别再配它
真正省事又可靠的做法:用原生 Pagination 类 + 简单 CSS 覆盖
除非有强交互需求(如无限滚动、局部刷新),否则没必要硬套前端分页。CodeIgniter 的 Pagination 类足够稳定,只需几行配置就能输出符合现代 UI 的 HTML:
- 用
full_tag_open/full_tag_close包住整个导航,加 Bootstrap class:$config['full_tag_open'] = '<nav><ul class="pagination">'</ul></nav> - 数字链接用
num_tag_open套<li>,当前页用cur_tag_open = '<li class="page-item active"><span class="page-link">'</span></li> - 禁用 rel 属性避免干扰 SEO:
$config['reuse_query_string'] = TRUE(保留其他 GET 参数)+$config['attributes'] = ['rel' => ''] - 样式问题一律交给 CSS,不要在 PHP 里拼 style 属性
复杂点在于页码逻辑和 URL 结构的耦合——uri_segment 值必须和真实路由段数严丝合缝,差 1 就 404 或永远显示第一页。这点没法绕,只能动手测。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











