在 Symfony 中集成 Elasticsearch 需完成客户端配置、实体映射、索引管理与查询逻辑四步：安装客户端并配置服务；创建 Document 类定义索引结构；通过命令或事件监听同步数据；注入客户端构建 multi_match 查询并解析结果。
在 Symfony 项目中集成 Elasticsearch 实现全文搜索功能，需完成客户端配置、实体映射、索引管理与查询逻辑四部分，缺一不可。
安装和配置 Elasticsearch 客户端
执行 composer require elasticsearch/elasticsearch 安装官方 PHP 客户端。
在 config/services.yaml 中定义 elasticsearch.client 服务，使用 Elasticsearch\ClientBuilder::create() 构建实例，并调用 ->setHosts(['http://localhost:9200']) 指向运行中的 Elasticsearch 服务。
这一步必须确保 Elasticsearch 服务已启动且网络可达，【若 localhost:9200 无法访问，后续所有操作都会返回 ConnectionException】。
定义可搜索的实体与文档映射
为需要搜索的 Doctrine 实体（如 App\Entity\Article）创建对应 Elasticsearch 文档结构。
在 src/Document/ArticleDocument.php 中定义类，添加 @ES\Document(index="articles") 注解，并用 @ES\Property(type="text") 标记 $title 和 $content 字段。
注意：Elasticsearch 不直接读取 Doctrine 实体，必须单独维护 Document 类；字段名、类型、分析器需与实际索引设置严格一致，否则搜索结果为空或报错。
同步数据到 Elasticsearch 索引
方法一：使用批量导入命令
创建自定义命令 php bin/console app:es:sync-articles，在 execute() 中获取 Doctrine EntityManager 查询全部 Article，遍历构造 ArticleDocument 实例，调用 $client->bulk() 提交批量索引请求。
方法二：监听 Doctrine 事件自动同步
注册 PostPersist 和 PostUpdate 事件监听器，在回调中调用 $client->index() 单条写入；删除时调用 $client->delete()。这种方式实时性高，但需处理事务一致性——【若数据库写入成功而 ES 写入失败，会导致数据不一致】。
实现搜索逻辑与控制器调用
第一步：在服务类中注入 Elasticsearch\ClientInterface。
第二步：构建查询数组，例如：['query' => ['multi_match' => ['query' => $keyword, 'fields' => ['title^3', 'content']]]]。
第三步：调用 $client->search(['index' => 'articles', 'body' => $query]) 获取原始响应。
第四步：解析 ['hits']['hits'] 数组，将 _source 数据反序列化为 ArticleDocument 对象，再映射回业务模型或直接返回 API 响应。
