如何使用PHP获取Algolia超过1000条的搜索命中结果？

• Algolia 普通search接口默认带有最多返回1000条结果的硬限制，无论你怎么调整page、hitsPerPage参数，只要分页偏移量超过1000，接口就会直接返回空结果，这是平台层面的限制，不是你写的分页逻辑出错。
• 你当前的搜索参数里同时传了offset: 0、length: 1000，这两个参数和page/hitsPerPage的分页逻辑互斥，会干扰接口的分页计算，导致分页参数不生效。
• 现有分页终止逻辑有缺陷：你设置hitsPerPage为1000时，除了最后一页，其余所有页的返回结果数都是1000，用count($objects['hits']) <= 1000作为页码递增判断条件没有实际意义，同时你没有读取接口返回的总命中数、总页数字段做边界判断，会产生大量无效请求。

要拉取超过1000条匹配结果，不能继续用普通search接口做分页，必须使用Algolia专门为全量结果遍历设计的browse接口，这个接口没有1000条结果的上限，适合后端批量拉取全量匹配数据的场景。
需要注意几个调整点：

• 移除请求中冲突的offset、length参数，不要和分页参数混用
• browse接口不需要手动维护页码，它通过返回的cursor（游标）标记拉取位置，每次请求带上上一次返回的游标，就能持续拉取下一批结果，直到游标为空即代表所有结果拉取完成
• X-Forwarded-For、userToken是给前端用户实时搜索场景做个性化排序、行为分析用的参数，后端全量拉取数据时不需要传递，避免触发不必要的频率限制
• 不推荐手动修改索引后台的paginationLimitedTo参数来抬高普通search接口的返回上限，这个操作会大幅降低搜索响应速度，平台本身也不建议在生产环境这么配置。

如果你使用v3及以上版本的Algolia PHP SDK，可以直接用封装好的browseObjects方法，不需要手动处理游标：

function getAlgoliaResults($index, $query)
{
    global $ObjectidsArray;
    $idarray = array();
    
    // 初始化全量遍历请求，每批拉取1000条
    $resultIterator = $index->browseObjects([
        'query' => $query,
        'hitsPerPage' => 1000
    ]);

    // 遍历所有命中结果
    foreach ($resultIterator as $rec) {
        $ObjectidsArray[$rec['id']] = $rec['objectID'];
        array_push($idarray, $rec['id']);
    }

    return $idarray;
}

如果你使用v2及以下的旧版SDK，需要手动维护游标完成遍历，参考代码如下：

function getAlgoliaResults($index, $query)
{
    global $ObjectidsArray;
    $idarray = array();
    $cursor = null;

    do {
        $response = $index->browse([
            'query' => $query,
            'hitsPerPage' => 1000,
            'cursor' => $cursor
        ]);

        foreach ($response['hits'] as $rec) {
            $ObjectidsArray[$rec['id']] = $rec['objectID'];
            array_push($idarray, $rec['id']);
        }

        // 更新游标，没有返回游标说明已经拉取完所有结果
        $cursor = isset($response['cursor']) ? $response['cursor'] : null;
    } while ($cursor !== null);

    return $idarray;
}

内容的提问来源于stack exchange，提问作者Sarkar