ThinkPHP分页进阶：基于Elasticsearch的全文检索分页对接-ThinkPHP-PHP中文网

thinkphp 的 paginate() 无法直接用于 elasticsearch，因其依赖数据库 query 对象和 sql 概念（如 limit/offset），而 es 返回 json 响应、使用 from/size 分页且无链式方法；需手动处理分页参数、dsl 拼装、响应解析及分页结构封装。

thinkphp分页进阶：基于elasticsearch的全文检索分页对接

ThinkPHP 本身不提供 Elasticsearch 分页的原生支持，paginate() 不能直接套用在 ES 查询结果上；必须手动处理分页参数、拼装 DSL、解析响应，并自行封装分页结构。

为什么不能直接用 ThinkPHP 的 paginate()？

ES 返回的是 JSON 结构体，不是 ThinkPHP Query 对象，没有 select()、where() 链式调用能力，更不识别 limit/offset 这类 SQL 概念。直接传 ES 响应给 paginate() 会报错或返回空数组。

ES 的分页靠 from + size（浅分页），但深度分页（如 from=10000）会被拒绝，需改用 search_after
ES 响应里没有 total 字段的原始值，而是嵌在 response['hits']['total']['value'] 中，且可能为对象（ES 7.0+）
ThinkPHP 的分页器默认依赖数据库 count 查询，而 ES 的 count API 和 search 是分离的，不复用连接和上下文

如何手动实现 from/size 分页（适用于前 10000 条）

核心是把用户请求的 page 和 per_page 转成 from 和 size，并确保 DSL 正确包裹在 query 下层。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

from = ($page - 1) * $per_page，注意 $page 最小为 1，from 最大建议 ≤ 9990（避开 ES 默认 index.max_result_window=10000 限制）
DSL 必须是标准结构：['query' => [...], 'from' => 0, 'size' => 20]，别把 from 写到顶层同级于 query 外面
高亮、排序、聚合等字段要和 query 平级，不要塞进 query 里面

示例片段：

$params = [
    'index' => 'article_index',
    'body' => [
        'query' => [
            'multi_match' => [
                'query' => $keyword,
                'fields' => ['title^3', 'content']
            ]
        ],
        'from' => $from,
        'size' => $per_page,
        'highlight' => [
            'fields' => ['title' => new \stdClass(), 'content' => new \stdClass()]
        ]
    ]
];
$response = $this->client->search($params);

search_after 怎么接进 ThinkPHP 分页逻辑？

search_after 不依赖 from，而是用上一页最后一条文档的排序值做游标，适合深度分页和滚动场景，但需要前端传回上次的 sort 值。

首次请求不带 search_after，只传 size 和排序字段（如 ['created_at' => 'desc']）
响应中取 $response['hits']['hits'][count-1]['sort']，base64 编码后传给前端作为下一页 token
下一页请求时解码该 token，填入 'search_after' => $decoded_sort_values
注意：必须显式指定 sort，且字段需有 doc_values: true（mapping 中默认开启，但 text 字段若没开 fielddata 会报错）
ThinkPHP 里无法复用 LengthAwarePaginator，得自己构造分页数组，包含 data、last_page（ES 不直接返回总页数）、next_page_url（含 encoded sort）等键

中文分词 + 分页组合容易漏掉的关键点

分页本身不解决中文搜不到的问题，但会放大配置错误的影响——比如用 standard 分词器搜“笔记本”，第 1 页没结果，你可能以为数据没同步，其实是 mapping 没配 ik_smart，所有页都为空。

建索引时必须显式声明 analyzer 和 search_analyzer，例如：'title' => ['type' => 'text', 'analyzer' => 'ik_max_word', 'search_analyzer' => 'ik_smart']
更新分词器后，旧文档不会自动重索引，必须执行 _update_by_query 或重建索引，否则分页查出来的老数据仍按旧规则分词
如果用了 match_phrase 做短语匹配，分页时要注意 slop 参数是否合理，否则跨页可能漏掉相邻词序匹配的结果
ES 8.x 默认关闭 track_total_hits，若需精确总数（如显示“共 XXX 条”），得显式设 'track_total_hits' => true，但会轻微影响性能