PHP连不上Elasticsearch主因是cURL扩展未启用或被禁用，需检查phpinfo()中cURL support是否enabled，并确认allow_url_fopen及disable_functions未禁用curl_init等函数。
PHP 连不上 Elasticsearch，curl_init() 返回 false 怎么办
多数 PHP 项目连不上 ES 不是因为配置错，而是底层 curl 扩展没启用或被禁用。检查 phpinfo() 输出里有没有 cURL support => enabled，再确认 allow_url_fopen 和 disable_functions 里没禁掉 curl_init、curl_exec 等函数。
常见踩坑点：
- 本地开发用 MAMP/XAMPP 时，默认不开启 cURL，需手动勾选扩展
- Docker 容器里跑 PHP，镜像可能精简掉了
libcurl依赖，要加apt-get install -y libcurl4-openssl-dev - ES 地址写成
http://localhost:9200，但 PHP 容器里localhost指向自己，不是宿主或 ES 容器——得换http://elasticsearch:9200（Docker Compose 网络名）或宿主机 IP
用官方 PHP client 还是直接 curl 发请求
官方 elasticsearch-php client（v8.x）封装了连接池、重试、序列化等逻辑，适合中大型项目；但如果你只做简单关键词搜索、且 ES 版本固定（比如 v7.17），手写 curl 更轻量、更可控。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用 client：装
elasticsearch/elasticsearch:^8.0，初始化时传hosts和basicAuthentication即可，search()方法参数结构和 ES REST API 几乎一致 - 手写 curl：注意设置
CURLOPT_HTTPHEADER包含Content-Type: application/json，否则 ES 会返回406 Not Acceptable - v7 和 v8 的 mapping 类型已废弃，别在
body里写_type字段，否则报错"Unknown key for a START_OBJECT in [query]."
match vs match_phrase 搜索结果差很多
这是语义理解差异导致的——match 是分词后任意匹配，match_phrase 要求分词结果**顺序连续**出现。比如搜 “北京天气”，match 可能命中 “今天北京很热，明天天气转阴”，而 match_phrase 只会命中含完整短语的文档。
调用示例（client v8）：
$params = [
'index' => 'articles',
'body' => [
'query' => [
'match_phrase' => [
'title' => '北京天气'
]
]
]
];
$response = $client->search($params);
注意事项：
- 字段必须是
text类型且启用了标准分词器，否则match_phrase无意义 - 想兼顾相关性与精确度，可用
multi_match+type: phrase_prefix - 中文场景下，建议搭配
ik_smart或jieba分词插件，原生 standard 分词对中文基本无效
搜索结果高亮（highlight）不显示或错位
高亮失效通常不是 PHP 层问题，而是 ES 查询体或 mapping 配置不对。先确认字段在 mapping 中设置了 "highlight": true（默认 text 字段都支持），再检查 highlight 参数是否放在顶层 body 同级，而不是嵌在 query 里。
典型错误写法：
'body' => [
'query' => [/* ... */],
'highlight' => [ // ✅ 正确位置
'fields' => ['content' => new \stdClass()]
]
]
容易忽略的细节：
- 高亮字段内容如果被
source filtering过滤掉（比如只取_source => ['title']），则 highlight 无法提取原文，返回空数组 - 使用
require_field_match: false可让未匹配字段也参与高亮（比如搜 title，但想高亮 content） - PHP 接收响应后，
$response['hits']['hits'][0]['highlight']['content'][0]是字符串，不是 HTML 标签——<em></em>是 ES 返回的原始标记，需自行替换或转义
Elasticsearch 的 PHP 集成难点不在代码长度，而在每个环节都依赖外部状态：ES 集群健康度、mapping 定义、分词器行为、网络可达性。调试时优先看 $response['error'] 或 curl_error()，而不是直接改 PHP 逻辑。
