首先安装配置Elasticsearch并确保服务运行，接着通过Composer安装elasticsearch-php客户端库，然后在PHP中创建客户端连接并测试集群健康状态，之后定义索引设置并插入文档数据，最后使用Query DSL构造查询条件执行搜索并处理返回结果。
如果您希望在Web应用中实现高效的全文搜索功能，PHP与Elasticsearch的集成是一个理想选择。通过REST API，PHP可以轻松与Elasticsearch通信，实现数据索引、查询和管理。
本文运行环境：Dell XPS 15，Ubuntu 22.04
一、安装并配置Elasticsearch
Elasticsearch是基于Lucene构建的分布式搜索和分析引擎，需先在系统中正确部署才能与PHP交互。确保服务正常运行是后续集成的基础。
1、使用APT包管理器更新系统源并安装Java，因为Elasticsearch依赖Java运行环境：sudo apt update && sudo apt install openjdk-17-jre。
立即学习“PHP免费学习笔记（深入）”；
2、导入Elasticsearch官方GPG密钥并添加APT仓库：wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg。
3、添加Elasticsearch仓库到系统源列表：echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/8.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-8.x.list。
4、安装Elasticsearch服务：sudo apt install elasticsearch。
5、启动Elasticsearch并设置开机自启：sudo systemctl start elasticsearch && sudo systemctl enable elasticsearch。
6、验证服务是否运行：curl http://localhost:9200，应返回包含cluster_name和version信息的JSON响应。
二、安装PHP的Elasticsearch客户端库
官方提供的elasticsearch-php客户端封装了HTTP请求，简化了索引、搜索和删除等操作的代码编写，提升开发效率。
1、进入项目目录，使用Composer安装官方Elasticsearch PHP客户端：composer require elasticsearch/elasticsearch。
2、确认vendor目录已生成，并检查autoload.php是否存在以确保自动加载机制可用。
3、在PHP脚本顶部引入自动加载文件：require 'vendor/autoload.php';，为后续调用客户端类做准备。
三、建立PHP与Elasticsearch的连接
通过创建Client实例，PHP可以向Elasticsearch发送请求。连接配置支持集群节点、超时设置和认证信息，适用于不同部署环境。
1、初始化Elasticsearch客户端，指定服务地址：$client = ClientBuilder::create()->setHosts(['localhost:9200'])->build();。
2、可选地设置连接超时和重试次数，增强稳定性：->setRetries(2)。
3、执行一个简单的集群健康检查请求：$response = $client->cluster()->health(); print_r($response);，确认连接成功。
四、创建索引并插入文档数据
索引相当于数据库中的表，用于存储结构化或非结构化数据。通过定义映射（mapping）可控制字段类型和分析方式。
1、定义索引参数数组，包括索引名称和设置项：$params = ['index' => 'products', 'body' => ['settings' => ['number_of_shards' => 1]]];。
2、调用create方法提交索引创建请求：$client->indices()->create($params);。
3、准备要索引的文档数据，如商品信息：'body' => ['name' => 'Laptop', 'price' => 1200]。
4、将文档加入指定索引：$client->index(['index' => 'products', 'id' => '1', 'body' => $document]);。
五、执行搜索查询并处理结果
利用Query DSL，可以在PHP中构造复杂的搜索条件，如全文匹配、范围查询和布尔逻辑，满足多样化检索需求。
1、构建搜索参数，指定目标索引和查询条件：$params = ['index' => 'products', 'body' => ['query' => ['match' => ['name' => 'Laptop']]]];。
2、调用search方法获取响应结果：$result = $client->search($params);。
3、遍历命中结果并输出关键字段：foreach ($result['hits']['hits'] as $hit) { echo $hit['_source']['name']; }。
4、可扩展查询条件，例如加入过滤器限制价格区间：'range' => ['price' => ['gte' => 1000, 'lte' => 1500]]。
