ThinkPHP 5.0.24 集成 Elasticsearch 必须手动安装 elasticsearch/elasticsearch:^7.0 客户端，启用 ext-curl 和 ext-json，用 ClientBuilder::create() 初始化并配置 hosts，显式创建带 ik_smart 分词器的索引以支持中文搜索。
ThinkPHP 5.0.24 本身不支持 Elasticsearch，必须手动集成官方 PHP 客户端，并做适配配置。关键不是“开启支持”，而是正确安装兼容版本的客户端、补全依赖、初始化连接并创建带中文分词的索引。
选对客户端版本
TP5.0.24 通常运行在 PHP 7.2～7.4 环境下，对应 Elasticsearch 服务端建议用 7.x（如 7.17），客户端必须用 elasticsearch/elasticsearch:^7.0。
- 执行
composer require elasticsearch/elasticsearch:^7.0，不要用 ^8.0 或 ^6.0 - 装完后运行
php -r "echo class_exists('Elasticsearch\ClientBuilder') ? 'ok' : 'fail';"验证类是否可加载 - 若报错，检查是否漏了
composer dump-autoload
确保 PHP 环境可用
客户端依赖 ext-curl 和 ext-json，缺一不可：
- 运行
php -m | grep curl和php -m | grep json，确认两个扩展已启用 - 若未启用 cURL，编辑 php.ini，取消注释
extension=curl，然后重启 PHP-FPM 或 Apache - PHP 版本需 ≥7.2，低于此版本会安装失败或运行异常
初始化客户端并测试连通
TP5 不提供自动服务注册，需在控制器或公共方法中手动构建 Client：
立即学习“PHP免费学习笔记（深入）”；
- 使用
ClientBuilder::create()（v7 支持，v8 已移除） - 显式设置 hosts，例如
['http://127.0.0.1:9200'] - 调用
$client->info()测试连接；若报cURL error 7，说明 ES 未启动、未监听 0.0.0.0，或防火墙/云服务器安全组未放行 9200 端口
中文搜索必须配 IK 分词器
Elasticsearch 默认 standard 分词器对中文无效，直接建索引会导致搜不到结果：
- 确认 Elasticsearch 已安装对应版本的
analysis-ik插件（如 ES 7.17 → ik 7.17） - 创建索引时显式定义 mapping，为 text 字段指定
"analyzer": "ik_smart" - 示例字段配置：
"title": {"type": "text", "analyzer": "ik_smart"} - 建好索引后，访问
http://127.0.0.1:9200/your_index/_mapping查看 analyzer 是否生效
