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、或把数字页码包进

，全得手写参数。

常用参数示例：

$config['full_tag_open'] = '';
$config['first_link'] = '« First';
$config['last_link'] = 'Last »';
$config['next_link'] = 'Next →';
$config['prev_link'] = '← Previous';
$config['num_tag_open'] = '
';
$config['num_tag_close'] = '
';
$config['cur_tag_open'] = '
';
$config['cur_tag_close'] = '
';

注意点：

• 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 的能力；真要灵活性，要么自己封装一个带查询逻辑的分页服务类，要么接受它的契约：分页归分页，数据归数据——边界清晰，但也意味着每处列表都要写几行固定样板。

https://www.php.cn/faq/1986253.html