ThinkPHP分页开发：实现带缩略图与摘要的图文列表分页-ThinkPHP-PHP中文网

thinkphp 6 的 paginate() 默认不支持关联字段自动拼装，需用 join() + field() 显式关联查询；with() 会导致 n+1 查询；摘要宜用 db::raw 截取；分页渲染应手动遍历 getcollection()；缩略图 url 需动态适配 cdn 且避免缓存污染。

thinkphp分页开发：实现带缩略图与摘要的图文列表分页

ThinkPHP 6 的 `paginate()` 默认不支持关联字段自动拼装

直接调用 $model->paginate() 只会查出主表数据，thumb（缩略图字段）和 digest（摘要字段）如果在关联表（比如 article_content）里，分页结果里根本不会出现——这不是 Bug，是设计使然：TP6 的分页底层走的是 Query::select()，不主动 join 就不会带出关联字段。

常见错误现象：foreach($list as $item) 里访问 $item->thumb 报 Notice 或空值；调试输出 $list->toArray() 发现数组里只有 id/title/create_time 等主表字段。

必须显式指定需要的字段，用 field() + withJoin() 或原生 join()
若用 with(['content'])，分页后每个 item 会额外触发一次查询（N+1），严重拖慢首屏速度
摘要字段常被截取（如 substr($content, 0, 120)），但数据库层截取更高效，推荐用 DB::raw('SUBSTR(content, 1, 120) AS digest')

用 `join()` + `field()` 构造单次查询分页

这是最稳、最可控的方式，尤其适合图文列表这种强展示需求。核心是把缩略图和摘要字段“拉平”到主查询结果中，让分页器一次性拿到全部所需字段。

假设主表为 articles，内容表为 article_contents，结构如下：

articles: id, title, category_id, created_at
article_contents: article_id, thumb, content

控制器中写法示例：

$list = Db::name('articles')
    ->alias('a')
    ->join('article_contents ac', 'a.id = ac.article_id')
    ->field('a.id,a.title,a.created_at,ac.thumb,ac.content')
    ->where('a.status', 1)
    ->order('a.created_at DESC')
    ->paginate(10, false, ['query' => request()->param()]);

注意点：

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

paginate(10, false, [...]) 第二个参数 false 表示不自动附加查询参数到分页链接（避免重复传参），实际要用 request()->param() 手动透传
摘要若需截断，把 ac.content 换成 DB::raw("SUBSTR(ac.content, 1, 120) AS digest")，模板里直接用 $item['digest']
缩略图字段建议加非空判断，模板中写 <img src="%7B%7B%20%24item['thumb']%20?:%20'/static/img/placeholder.png'%20%7D%7D">

模板里分页渲染要避开 `render()` 的默认样式陷阱

TP6 的 $list->render() 输出的是带 <ul><li></ul> 的 HTML，但很多前端框架（如 Tailwind、Bootstrap 5）或自定义 CSS 依赖特定 class 或结构，直接套用会导致样式错乱或 JS 失效。

更稳妥的做法是手动遍历分页信息，用原生 HTML 控制结构：

<div class="pagination">
  <?php if ($list->onFirstPage()): ?>
    <span class="disabled">上一页</span>
  <?php else: ?><a href="?page=<?=%20%24list->currentPage()%20-%201%20?>">上一页</a>
  <?php endif; ?><p><?php foreach ($list->render()->getCollection() as $page): ?>
<a href="?page=<?=%20%24page['url']%20?>" class="<?= $page['active'] ? 'active' : '' ?>">
= $page['text'] ?>
</a>
<?php endforeach; ?></p>
<p><?php if ($list->hasMorePages()): ?>
<a href="?page=<?=%20%24list->currentPage()%20+%201%20?>">下一页</a>
<?php else: ?><span class="disabled">下一页</span>
<?php endif; ?></p>
</div>

关键提醒：

$list->render()->getCollection() 返回的是分页项数组，每项含 text、url、active 字段，比解析 HTML 字符串安全得多
不要用 str_replace() 去改 render() 输出的 HTML，容易破坏 URL 编码或嵌套结构
移动端需加 aria-current="page" 提升可访问性，对应 active 项加该属性

缩略图路径动态适配与 CDN 场景不能硬编码

开发时本地路径是 /uploads/thumb.jpg，上线后可能走 CDN，变成 https://cdn.example.com/uploads/thumb.jpg。如果模板里写死 src="/uploads/..."，上线就挂。

正确做法是在模型或配置层统一处理：

在 config/filesystem.php 中配置 public 磁盘的 url 项，指向 CDN 域名（开发环境设为 /，生产环境设为完整 URL）
模板中统一用 Url::build($item['thumb']) 或封装函数 getThumbUrl($item['thumb'])，内部判断是否以 http 开头，否则补前缀
数据库存相对路径（如 uploads/2024/05/thumb_abc.jpg），绝不存绝对 URL