Symfony 2 必须使用 FOQElasticaBundle（非 FOSElasticaBundle）集成 Elasticsearch，需配置 client 端口、analyzed 字符串类型及 ik 中文分词器，手动执行 populate 命令同步数据，并通过 finder 服务将搜索结果转为实体对象。
Symfony 2 本身不支持全文搜索，Doctrine 的 LIKE 或 MySQL MATCH AGAINST 在中文、多字段、高并发下极易失效；真正可用的方案是接入 Elasticsearch，并通过 FOSElasticaBundle（注意：Symfony 2 对应的是早期版本 FOQElasticaBundle）完成深度集成——它不是简单调用客户端，而是把索引同步、数据映射、查询反查全包进 Symfony 生命周期。
确认用对 Bundle 版本
Symfony 2.x（如 2.8）必须使用 FOQElasticaBundle，而非现代 Symfony 6+ 用的 FOSElasticaBundle。装错会导致服务注册失败、命令不可用：
- 执行
composer require friendsofsymfony/elastica-bundle:3.2.*（兼容 Symfony 2.8 的最后稳定版） - 在
app/AppKernel.php中注册：new FOS\ElasticaBundle\FOSElasticaBundle() - 若报
Class 'FOS\ElasticaBundle\FOSElasticaBundle' not found，说明装了新版 Bundle，需降级
基础配置要避开三个坑
app/config/config.yml 中的配置看似简单，但三处写错就会导致索引建不起来或搜不到结果：
elasticsearch-9.4.1-linux
下载
Elasticsearch 9.4.1 Linux 版本现已开放下载，这是官方最新发布的分布式搜索与分析引擎。Linux 版本全面支持 x86_64 与 aarch64 架构，提供 .tar.gz、.deb 及 .rpm 多种安装包格式，可灵活适配 Ubuntu、CentOS、Debian 等主流发行版。该版本延续了 9.4 系列的核心特性，包括原生 Prometheus 支持、正式版 Elast
-
client 地址必须带端口：写成
{ host: localhost, port: 9200 }，不能只写localhost:9200字符串 -
mappings 字段类型别混用：搜标题/内容必须用
type: string, index: analyzed；ID、状态码等精确匹配字段才用index: not_analyzed -
analyzer 要配对中文插件：默认
standard对中文无效，需提前在 Elasticsearch 安装ik插件，并在 mapping 中显式指定：analyzer: ik_max_word
数据同步必须手动触发首次填充
FOQElasticaBundle 不像新版那样自动监听 Doctrine 事件（尤其在 Symfony 2 中 listener 支持有限），所以首次导入和后续补数据必须靠命令：
- 运行
php app/console fos:elastica:populate把现有数据库数据批量写入 ES - 如果中途失败，索引会残缺——建议加
--no-reset参数避免清空已有索引再重导 - 日常更新依赖手动同步逻辑：在 Entity 的
postUpdate事件里调用$elasticaIndex->updateOne($document)，或用消息队列延后处理
控制器里查搜索结果要转回实体
直接从 ES 拿到的是原始数组，而业务代码通常需要 Doctrine 实体对象。FOQElasticaBundle 提供 Finder 服务帮你完成这层转换：
- 在 Controller 中注入
fos_elastica.finder.app.article（服务 ID 格式为fos_elastica.finder.[index_name].[type_name]） - 调用
$finder->find('关键词')返回的是App\Entity\Article实例列表，可直接用->getTitle()等方法 - 若返回空但你知道数据在 ES 里，先用
curl "http://localhost:9200/app/article/_search?q=title:关键词"验证是否是映射或 analyzer 不匹配
