Symfony中集成Elasticsearch需通过Console命令管理索引、按业务触发实体同步、封装SearchService解耦查询，并用Docker和集成测试保障环境一致性。
在 Symfony 项目中快速集成 Elasticsearch 实现全文检索，核心在于命令行工具支持、数据同步机制和查询逻辑解耦。不需要重写业务层，重点是让索引管理可维护、搜索逻辑可复用。
使用 Symfony Console 命令管理索引
通过自定义命令统一处理索引创建、映射设置和别名切换，避免手动调用 curl 或依赖外部脚本。
- 继承 Command 类，注入 Elasticsearch\Client（推荐使用 official elasticsearch-php 客户端）
- 在 configure() 中定义命令名如 app:es:index:create，支持 --env 和 --force 参数
- 执行时先检查索引是否存在，再调用 indices()->create() 并传入 mapping 数组（字段类型、analyzer 配置需明确）
- 生产环境建议用别名（如 product_search）指向真实索引（如 product_search_v2），命令中完成原子性切换
自动同步 Doctrine 实体到 Elasticsearch
不推荐监听所有 update/delete——应按业务场景触发，兼顾性能与一致性。
- 在 Entity Repository 或 Service 中封装 syncToElasticsearch() 方法，接收 ID 或实体对象
- 使用 bulk() 批量写入：一次请求提交多条文档，比单条索引快 5–10 倍
- 对软删除实体，同步时跳过或写入 "status": "deleted" 字段，查询时加过滤条件
- 异步场景可用 Messenger：发送 SyncProductToEsMessage，由 handler 调用同步逻辑，失败可重试
构建可复用的搜索服务
把查询逻辑从 Controller 抽离，支持分页、高亮、聚合，同时屏蔽底层客户端细节。
- 定义 SearchService，构造函数注入 Client 和默认 index 名称
- 提供 search(string $query, array $options = []) 方法，$options 支持 from、size、highlight、aggs
- 使用 match_phrase_prefix 替代简单 match，提升中文/英文前缀搜索体验
- 返回结构化结果：含 hits（带 source + highlight）、total、aggregations，Controller 只负责响应格式转换
本地开发与测试支持
避免因环境差异导致搜索功能上线后异常。
- Docker Compose 中声明 elasticsearch 服务，Symfony 环境变量配置 ELASTICSEARCH_URL=http://es:9200
- 为测试编写 EsTestCase，启动轻量级 testcontainer（如 docker.elastic.co/elasticsearch/elasticsearch:8.12.2）
- 单元测试中 mock Client 不够真实——集成测试应真正写入、查询、断言结果数量与字段内容
- 命令行添加 --dry-run 参数，预览将执行的操作而不真正调用 ES API
