原生 PHP + MySQL + Elasticsearch 实现高性能搜索,是现代 Web 应用的标准架构:
- MySQL 作为唯一数据源(Single Source of Truth)
- Elasticsearch 作为高性能搜索索引(Read-Optimized Index)
- PHP 作为协调层(Orchestrator)
核心挑战在于:如何保证 MySQL 与 ES 数据最终一致,同时实现毫秒级搜索。
90% 的失败源于“直接写 ES”或“忽略数据同步”。
一、架构设计:读写分离 + 数据同步
🧱核心原则
- 写操作只写 MySQL(保证 ACID)
- 读操作只读 ES(保证高性能)
- MySQL → ES 同步异步化(解耦)
🔑真相:ES 是 MySQL 的“只读副本”,非独立数据源。
二、同步策略:三种可靠方案
🔄方案 1:应用层同步(推荐)
- 流程:
- PHP 更新 MySQL
- 成功后异步更新 ES(Kafka/Worker)
- 代码:
// 1. 更新 MySQL$pdo->beginTransaction();$pdo->prepare("UPDATE articles SET title = ? WHERE id = ?")->execute([$title,$id]);$pdo->commit();// 2. 异步同步到 ES(通过 Kafka)$kafkaProducer->send('es_sync',['table'=>'articles','id'=>$id,'action'=>'update']); - 优势:简单、可控;
- 劣势:代码侵入;
🔄方案 2:Binlog CDC 同步(高可靠)
- 工具:Debezium / Canal
- 流程:
- MySQL 开启 Binlog
- Debezium 监听 Binlog → 写入 Kafka
- Worker 消费 Kafka → 更新 ES
- 优势:解耦、无代码侵入;
- 劣势:运维复杂;
🔄方案 3:定时全量同步(兜底)
- 流程:每小时 SELECT * FROM MySQL → 全量覆盖 ES
- 适用:小数据量 + 允许延迟;
- 代码:
// cron job$articles=$pdo->query("SELECT * FROM articles")->fetchAll();$esClient->index(['index'=>'articles','body'=>['docs'=>$articles]]);
✅生产推荐:应用层同步 + 定时全量兜底。
3. 搜索实现:原生 PHP 核心代码
🧪1. 初始化 ES 客户端
// es_client.phpuseElasticsearch\ClientBuilder;classESClient{private$client;publicfunction__construct(){$this->client=ClientBuilder::create()->setHosts(['http://elasticsearch:9092'])->build();}publicfunctionsearch(string$index,string$query,int$page=1,int$size=20){$from=($page-1)*$size;$params=['index'=>$index,'body'=>['query'=>['multi_match'=>['query'=>$query,'fields'=>['title^3','content']// 标题权重 3 倍]],'highlight'=>['fields'=>['title'=>new\stdClass(),'content'=>new\stdClass()]],'from'=>$from,'size'=>$size]];return$this->client->search($params);}}🧪2. 搜索控制器
// search.phprequire'es_client.php';$query=$_GET['q']??'';$page=(int)($_GET['page']??1);$size=20;if(!$query){die('Missing query');}$es=newESClient();$response=$es->search('articles',$query,$page,$size);$results=[];foreach($response['hits']['hits']as$hit){$results[]=['id'=>$hit['_id'],'title'=>$hit['highlight']['title'][0]??$hit['_source']['title'],'content'=>$hit['highlight']['content'][0]??$hit['_source']['content'],'score'=>$hit['_score']];}$total=$response['hits']['total']['value'];$totalPages=ceil($total/$size);🧪3. 同步 Worker(消费 Kafka)
// sync_worker.php$consumer=newRdKafka\KafkaConsumer($conf);$consumer->subscribe(['es_sync']);while(true){$message=$consumer->consume(1000);if($message->err===RD_KAFKA_RESP_ERR_NO_ERROR){$event=json_decode($message->payload,true);switch($event['action']){case'update':$article=$pdo->query("SELECT * FROM articles WHERE id ={$event['id']}")->fetch();$esClient->index(['index'=>'articles','id'=>$article['id'],'body'=>$article]);break;case'delete':$esClient->delete(['index'=>'articles','id'=>$event['id']]);break;}$consumer->commit();}}四、避坑指南:五大高危误区
🚫 误区 1:“直接写 ES,不同步 MySQL”
- 真相:ES 无事务 → 数据丢失风险高;
- 解法:MySQL 为唯一写入点;
🚫 误区 2:“同步失败无重试”
- 真相:网络抖动 → ES 数据缺失;
- 解法:Kafka 消息 + 重试机制;
🚫 误区 3:“忽略 ES 映射设计”
- 真相:默认映射不支持中文分词;
- 解法:预定义 Index Template:
{"mappings":{"properties":{"title":{"type":"text","analyzer":"ik_max_word"},"content":{"trype":"text","analyzer":"ik_max_word"}}}}
🚫 误区 4:“不分页搜索”
- 真相:
size=10000→ ES 拒绝(默认 max_result_window=10000); - 解法:用 Search After 替代深度分页;
🚫 误区 5:“无兜底对账”
- 真相:同步失败 → ES 与 MySQL 不一致;
- 解法:定时任务校验关键数据;
五、终极心法:搜索是数据管道的艺术
不要把 ES 当数据库,
而要当 MySQL 的高性能只读视图。
- 脆弱架构:
- ES 直写 → 数据不一致;
- 韧性架构:
- MySQL 写 → 异步同步 → ES 读;
- 结果:
- 前者随流量崩溃,后者随流量扩展。
真正的搜索系统,
不在“ES 多强”,
而在“管道多稳”。
六、行动建议:今日搜索系统搭建
## 2025-10-02 搜索系统搭建 ### 1. 搭建环境 - [ ] Docker 启动 MySQL + Elasticsearch + Kafka ### 2. 配置 ES 映射 - [ ] 定义 articles 索引模板(含中文分词) ### 3. 实现同步 - [ ] PHP 写 MySQL → Kafka → Worker 同步 ES ### 4. 验证搜索 - [ ] 搜索关键词 → 验证高亮 + 分页✅完成即构建高可靠搜索管道。
当你停止用“ES 直写”冒险,
开始用“MySQL 为源”构建管道,
搜索就从功能,
变为可靠服务。
这,才是专业 PHP 工程师的搜索观。