CodeIgniter分页类仅生成HTML和计算偏移量,不处理数据查询;需手动获取总数、截取数据,并正确配置base_url与uri_segment,CI4的Pager才支持自动分页。

CodeIgniter 的分页类(Pagination)本身不处理数据查询,只负责生成分页 HTML 和计算偏移量,所以“功能全吗”取决于你怎么用它——它足够轻量,但绝不自动帮你查数据库或适配不同 ORM。
分页类不接管数据查询,$this->pagination->create_links() 只输出 HTML
这是最容易误解的一点。CI 的 Pagination 类完全不知道你查了多少条数据、用的什么模型、是否用了 limit() 或 offset()。它只根据你传入的 total_rows、per_page、uri_segment 等参数算出当前页、总页数、链接地址,并返回一串 HTML 字符串。
常见错误现象:
- 页面显示分页链接,但点击后数据没变——因为你没在控制器里手动更新
limit和offset -
create_links()返回空字符串——大概率是total_rows为 0 或负数,或者per_page设成了 0
实操建议:
- 必须自己调用模型获取总数:
$total = $this->user_model->count_all(); - 必须手动截取数据:
$data['users'] = $this->user_model->limit($per_page, $offset)->get()->result(); -
$offset要从 URI 段中读取,通常用$this->uri->segment(3)(假设 URL 是/users/page/15)
base_url 和 uri_segment 配置错一个,分页链接就 404
CI 分页链接默认拼接的是完整 URL,但如果你的路由用了伪静态(比如 users/page/2)、或启用了子目录部署(如 http://example.com/myapp/),base_url 和 uri_segment 就必须显式指定,否则生成的链接会指向错误路径。
实操建议:
-
base_url应设为不含页码的基准路径,例如:'base_url' => site_url('users/index')或'base_url' => '/users/index' -
uri_segment必须对应实际分页参数所在 URI 段号,比如 URL 是/admin/users/20,且页码在第 3 段,则设'uri_segment' => 3 - 避免混用
site_url()和base_url():前者加 index.php(若未重写),后者不加,选一个统一风格
自定义分页样式只能靠 full_tag_open 等参数,没法直接换模板文件
CI 3.x 的 Pagination 不支持 Twig 或视图文件注入,所有 HTML 结构都靠一堆字符串配置项硬控。想实现「上一页 / 下一页」文字、添加 Bootstrap class、或把数字页码包进 ,全得手写参数。
宽维企业网站管理系统功能说明宽维系列网站管理系统全面免费,个人和商业应用均免费。宽维企业网站管理系统是基于Php+MySql技术开发的企业电子商务平台,全后台操作,无需学习网页制作等知识。前台智能生成页面,可以方便地在线管理、维护、更新您的企业网站。宽维企业网站管理系统安装简单快捷,5分钟就可以安装完成。1 栏目管理方便灵活:可以发布和管理您需要的任何内容的个性栏目。内置数十个功能发布模型,并可以
常用参数示例:
$config['full_tag_open'] = ''; $config['first_link'] = '« First'; $config['last_link'] = 'Last »'; $config['next_link'] = 'Next →'; $config['prev_link'] = '← Previous'; $config['num_tag_open'] = '
注意点:
-
cur_tag_open和cur_tag_close包住的是当前页数字,不是链接;如果要让它可点击,得额外改逻辑(CI 默认当前页不带) - Bootstrap 5 要求
内部用或,而 CI 默认对当前页用,这反而是符合规范的 - 别漏掉
attributes参数(CI 3.1.11+ 支持),可统一给所有链接加class="page-link"
CI 4 的 Pager 更灵活,但和 CI 3 的 Pagination 不兼容
CI 4 把分页逻辑拆成 Pager 类 + 数据库的 paginate() 方法,支持自动计算总数、自动注入 offset/limit、还能配合 Model::paginate() 一行搞定。但它和 CI 3 的配置方式、方法名、返回结构完全不同,不能平滑迁移。
CI 4 典型用法:
$pager = \Config\Services::pager(); $users = $this->userModel->paginate(10, 'group1'); // 自动处理 limit/offset $data['pager'] = $this->userModel->pager;
关键差异:
- CI 4 的
paginate()会自动执行两次查询(一次 count,一次 select),CI 3 必须手动写两次 - CI 4 的分页链接默认基于当前 URL,不用再配
base_url,但需确保路由允许 query string(如?page=2)或启用伪静态支持 - CI 4 的
Pager支持多组分页共存(通过group参数隔离),CI 3 只能单实例
如果你还在用 CI 3,别指望靠升级某个 helper 就获得 CI 4 的能力;真要灵活性,要么自己封装一个带查询逻辑的分页服务类,要么接受它的契约:分页归分页,数据归数据——边界清晰,但也意味着每处列表都要写几行固定样板。









