CodeIgniter分页实现方法与技巧

CodeIgniter的分页看似简单，实则处处是“坑”：它不自动查库、不解析URL参数、不校验HTML标签，全靠开发者手动串联总数统计、URI段提取、offset计算、base_url配置和标签闭合等关键环节——稍有疏忽就会导致页码错乱、链接404、布局崩溃或安全风险，本文直击五大高频陷阱，帮你一次性理清分页背后必须亲手把关的底层逻辑与实战细节。

分页类初始化必须传入总记录数

CodeIgniter 的 Pagination 类本身不查数据库，只负责生成 HTML 分页链接和偏移量计算。你得自己先查出总条数，再传给 $this->pagination->initialize() 的 total_rows 参数，否则页码会全乱——比如显示“1 of 0”或直接不渲染页码。

常见错误是把模型返回的「当前页数据」条数（如 10 条）误当 total_rows，结果分页控件认为总共只有 10 条，永远只显示第 1 页。

• 先调用模型方法获取总数：$total = $this->article_model->count_all();
• 再查当前页数据（注意用 limit + offset）：$data['articles'] = $this->article_model->get_by_page($per_page, $offset);
• total_rows 必须是总数，不是当前页条数

URL 分页参数默认走 URI 片段，不是 ?page=2

CI 默认用 URI 路径方式传递页码，例如 /news/page/2，而不是 /news?page=2。如果你没配置 base_url 或路径不匹配，点击页码会跳到首页或 404。

关键点在于 base_url 必须和当前控制器方法的可访问路径一致，且末尾不带斜杠（CI 会自动补）。

• 正确写法：'base_url' => site_url('news/index') → 生成链接如 /index.php/news/index/page/2
• 错误写法：'base_url' => site_url('news') → 实际请求变成 /index.php/news/page/2，可能路由不通
• 若想改用查询参数（?per_page=2），需设 'use_page_numbers' => TRUE 并手动解析 $_GET['per_page']，但 CI 原生不推荐

offset 计算必须用 $this->uri->segment() 手动取值

CI 分页类不自动帮你读取当前页码并算 offset，你得从 URI 中手动提取页码片段，再换算成数据库偏移量。

默认情况下，页码在 URI 第 3 段（如 /news/index/page/2 中的 2），但 segment 编号从 1 开始，所以要用 $this->uri->segment(4)（因为 page 占第 3 段，页码值在第 4 段）。

• 获取当前页码：$page = ($this->uri->segment(4)) ? $this->uri->segment(4) : 1;
• 算 offset：$offset = ($page - 1) * $per_page;
• 务必校验 $page 是正整数，避免 SQL 注入或负偏移
• 如果用了 'use_page_numbers' => TRUE，则页码就是数字本身，不用减 1 算 offset

样式混乱时优先检查 $config['full_tag_open'] 是否闭合

分页 HTML 输出靠 full_tag_open/full_tag_close 等配置项拼接，一旦漏写闭合标签（比如 'full_tag_close' => '' 写成 'full_tag_close' => '