ThinkPHP分页模板：通过render方法传入自定义模板名称的规范-ThinkPHP-PHP中文网

thinkphp的render()传入模板名是资源标识符而非路径，如'common/paginate'对应view/common/paginate.html；多主题下用'mobile@common/paginator'；模板中通过$page变量调用方法，不可直接访问私有属性。

thinkphp分页模板：通过render方法传入自定义模板名称的规范

ThinkPHP 的分页对象调用 render() 时，传入字符串参数即表示使用自定义模板。这个字符串不是文件路径，而是模板资源标识符，格式为 主题名@路径/模板名（如未启用多主题，主题名可省略）。默认情况下，它会从 view 目录下查找，且自动补全 .html 后缀。

若模板位于 view/common/paginate.html，应传 'common/paginate'（不带 .html）
若在 view/admin/layout/pager.html，传 'admin/layout/pager'
使用 ThinkPHP 多主题功能时，如主题名为 mobile，则传 'mobile@common/paginator'
模板中无法直接访问原始分页对象的私有属性（如 $this->lastPage），需通过 $page 变量（think\paginator\Paginator 实例）调用公开方法，例如 $page->lastPage()

ThinkPHP 分页模板本质是视图片段，render() 会把当前 Paginator 实例以 $page 变量注入。模板中若漏掉关键逻辑，会导致跳转失效或数据错乱。

必须用 $page->render() 或 $page->links()（v6.1+ 推荐）来生成页码 HTML；直接写死 <a href="?page=2"></a> 会丢失 URL 参数（如搜索条件）
当前页码需用 $page->currentPage()，不能依赖 input('page') —— 分页器可能被嵌套或重写，请求参数未必叫 page
总页数取 $page->lastPage()，总数用 $page->total()，不要用 count($data) 替代
上一页链接需判断：<?php if ($page->hasPrevious()): ?><a href="<?=%20%24page->previousPageUrl()%20?>">上一页</a><?php endif; ?>

最常遇到的两个现象：一是抛出 TemplateNotFoundException，二是页面只显示空 <div></div>。

ARC Lab

一款提供AI人像处理、图像增强和智能抠图等能力的视觉处理工具集合，方便用户在线体验多种图片优化功能。

下载

报错 Template not found: xxx：说明传给 render() 的字符串没匹配到任何模板文件，检查大小写、斜杠方向（Windows 下用 /，非 \）、是否漏掉 view/ 前缀（不需要加）、扩展名是否误写成 .php 或 .htm
渲染为空白：大概率是模板里没输出任何内容，或用了 echo 但被缓存拦截；更常见的是忘记开启 app_debug = true，导致错误静默；另一个隐蔽原因是模板中写了 =$page->render()?>，而 render() 方法本身已包含完整 HTML，再套一层会导致重复嵌套或 XSS 过滤干扰
v6.0+ 默认关闭 strip_tags 对分页输出的过滤，但若项目启用了全局输出过滤中间件，可能把 <a></a> 标签干掉了，此时要检查中间件配置中的 ResponseFilter 规则

分页模板是纯展示层，所有数据应在控制器中准备好并传入，模板内禁止出现数据库查询、文件读取、远程请求等操作。

不要在模板中调用 $page->items() 以外的方法来“重新获取数据”，这会破坏分页的懒加载逻辑
如需显示“共 X 条”，用 $page->total() 即可，不要额外查一次 COUNT(*)
若多个位置用同一套分页样式，建议把模板放在 view/common/ 下，统一维护；修改时注意清空 runtime/view/ 缓存，否则旧模板仍生效
模板中慎用 include 引入其他模板（如页码数字部分），ThinkPHP 的模板继承和包含机制在分页上下文中容易因变量作用域混乱导致 $page 不可用