Webman集成Elasticsearch搜索_PHP Webman高性能全文检索开发【高级】-php教程-PHP中文网

webman 集成 elasticsearch 必须使用 v8.x 官方客户端，禁用裸 curl；需显式配置 timeout、retry、ssl、连接池及 ik 分词器，client 实例须按请求创建，响应结构需适配 v8 新格式。

webman集成elasticsearch搜索_php webman高性能全文检索开发【高级】

Webman 集成 Elasticsearch 必须用 elasticsearch/elasticsearch v8.x 官方客户端，手写 cURL 或 file_get_contents 在常驻进程下极易引发连接泄漏、超时卡死、429 无退避等问题——这不是 Elasticsearch 不行，是客户端没选对、没配对。

为什么 Webman 不能用裸 cURL 调 ES

Webman 基于 Swoole 协程常驻内存，cURL 默认非协程安全，不支持连接复用池；官方客户端底层用 GuzzleHttp\Client，已适配 co::set(['hook_flags' => SWOOLE_HOOK_ALL])，能自动管理 TCP 连接生命周期。

cURL 初始化失败时静默报错（比如 php.ini 没开 extension=curl），ClientBuilder::create() 直接抛 Fatal error
没有内置重试逻辑：遇到 503 Service Unavailable 或 429 Too Many Requests 就崩，而官方客户端设 setRetries(3) 后可自动退避重试
无法控制单次请求耗时上限：裸 cURL 默认无限等待，一个慢查询就能拖垮整个 worker 协程
SSL 校验失败时行为不可控：Swoole 下 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false) 可能静默断连，查不到日志，但官方客户端设 setSSLVerification('/path/to/ca.crt') 才真正生效

连接配置必须显式声明 timeout 和 retry

Webman 是常驻进程，不能依赖客户端默认值。v8 客户端默认 timeout 是 30 秒，生产环境高延迟网络下极易阻塞协程。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

必须调用 setConnectionParams(['timeout' => 5.0, 'connect_timeout' => 3.0])，把单次请求硬限在 5 秒内
必须设 setRetries(3)，否则 429 错误不会重试，前端直接报错
Docker 环境下 hosts 别写 localhost:9200，要写容器名，如 http://elasticsearch:9200，否则 DNS 解析失败
v8 客户端不兼容 ES 7.x 服务端，若报 406 Not Acceptable，大概率是服务端版本太低，不是代码问题

中文搜索必须配 IK 分词器 + 显式 mapping

Elasticsearch 默认分词器对中文无效，text 字段直接切字，搜“搜索引擎”会匹配不到“搜索”或“引擎”单字——必须提前装好 ik 插件，并在创建索引时指定 analyzer。

ES 8.x 安装 IK 插件命令：bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v8.12.2/elasticsearch-analysis-ik-8.12.2.zip（版本号需与 ES 一致）
mapping 中字段要显式设："analyzer": "ik_max_word", "search_analyzer": "ik_smart"，否则建索引时不生效
别在 index() 时动态推导 mapping：ES 8.x 已废弃 type，且动态 mapping 对中文分词不可控
测试分词是否生效，用 _analyze API：POST /my_index/_analyze?analyzer=ik_max_word，传入文本看输出 token

协程生命周期里 client 实例不能复用跨请求

很多人把 $client 声明为全局变量或静态属性，在 Webman 的多 worker 多协程环境下，这会导致连接句柄被多个协程争抢，出现 Connection refused 或 Broken pipe。

client 实例应在每次请求中 new 或从 DI 容器 resolve，不要长期持有
若要用连接池，必须用 StaticConnectionPool 并设 maxConnections，例如：setConnectionPool(\Elasticsearch\ConnectionPool\StaticConnectionPool::class, ['connectionPoolParams' => ['maxConnections' => 20]])
别在 onWorkerStart 里初始化 client：worker 启动时 ES 可能还没就绪，应改为首次请求懒加载 + 缓存
所有异步操作（如 searchAsync）必须在协程上下文里执行，否则会退化为同步阻塞

最易被忽略的是：ES 8.x 响应结构变了，$response['hits']['hits'] 仍是主路径，但 _source 不再自动展开，高亮字段在 highlight 下且 key 名与字段名严格对应——少一个下划线或大小写错，前端就拿不到高亮内容。