Algolia 需手动集成：Composer 安装后，在控制器/模型中 use Algolia\AlgoliaSearch\SearchClient，从配置读取 App ID 和 Search API Key 初始化客户端；search() 返回原生响应，非 CI Query 对象，不可链式调用 result()；同步须显式调用 saveObject() 并处理失败重试。
Algolia 不是 CodeIgniter 原生支持的搜索后端，框架本身没有任何 Algolia 集成层或驱动。想用它，就得绕过 CI 的查询构建器，自己发 HTTP 请求。
怎么在 CodeIgniter 中调用 Algolia API
CI 项目里没有 Algolia\AlgoliaSearch\SearchClient 这类官方 SDK 的自动加载机制，你得手动引入（Composer 安装后）并初始化客户端：
- 确保已通过 Composer 安装：
composer require algolia/algolia-search - 在控制器或模型中显式引入：
use Algolia\AlgoliaSearch\SearchClient;
- 初始化时传入 App ID 和 API Key（别硬编码在代码里，应从环境变量或配置文件读）：
$client = SearchClient::create('YOUR_APP_ID', 'YOUR_SEARCH_ONLY_API_KEY'); - 搜索示例（注意：这是前端不可见的后端调用，不走数据库）：
$index = $client->initIndex('articles'); $response = $index->search($keyword, [ 'hitsPerPage' => 20, 'filters' => 'status:published', 'highlightPreTag' => '<mark>', 'highlightPostTag' => '</mark>' ]);
关键点：
-
search()返回的是 Algolia 原生响应结构，不是 CI 的Query对象，不能链式调用result()或row() - 所有分页、高亮、过滤逻辑都在 Algolia 侧完成，CI 层只负责转发请求和渲染结果
- 如果要用管理员 API Key（比如同步数据），必须严格隔离——绝不能暴露在前端可访问的控制器里
为什么不能用 $this->db->like() 接 Algolia
因为 like() 是数据库查询方法，底层生成 SQL；而 Algolia 是独立 SaaS 服务，通信协议是 HTTPS + JSON。两者不在同一抽象层级：
-
$this->db->like()→ MySQL 连接 →WHERE title LIKE '%xxx%' -
$index->search()→ cURL / Guzzle →POST <a href="https://www.php.cn/link/6dfaf51d9dac5fdcda240b043eb561d5">https://www.php.cn/link/6dfaf51d9dac5fdcda240b043eb561d5</a>
混用会导致：
- 查询永远查不到 Algolia 数据（CI 的 DB 类根本不知道 Algolia 存在哪）
- 日志里出现“Unknown column 'algolia_id'”这类误报（因开发者试图把 Algolia 返回字段当 DB 字段用）
- 调试时用
$this->db->last_query()查不到任何东西——因为压根没走数据库
Algolia 同步数据到索引的常见翻车点
CI 项目通常以 MySQL 为唯一数据源，Algolia 只是只读副本。同步必须主动触发，没有自动双写：
- 新增文章后，必须显式调用
$index->saveObject()或$index->saveObjects() - 更新或删除也一样，不能依赖“数据库改了 Algolia 就会感知”
- 最容易漏的是事务一致性：MySQL 插入成功但 Algolia 写失败 → 出现数据不一致
- 建议把同步逻辑封装成独立服务类，并加失败重试 + 日志记录，例如：
if (!$index->saveObject($article_data)->wait()) { log_message('error', 'Algolia sync failed for article ID: ' . $article_data['id']); }
Algolia 的响应结构和 MySQL 查询结果完全不同，直接 assign 给视图时字段名（如 hits、nbHits、query）都得手动适配，别指望 CI 的 result_array() 能自动转换。
