需通过composer安装elasticsearch-php客户端，配置https/basic auth连接参数，创建带text/float映射的索引，用bulk api导入数据，最后用match查询执行全文检索。
如果您正在开发PHP项目并希望集成Elasticsearch以实现高效全文检索，则需在PHP环境中正确安装官方客户端库，并完成基础搜索功能的初始化与调用配置。以下是具体实施步骤：
一、通过Composer安装Elasticsearch PHP客户端
使用Composer是PHP生态中管理依赖的标准方式，elasticsearch-php官方客户端支持现代PHP版本，安装后可直接实例化客户端对象进行通信。
1、确保系统已安装Composer且PHP版本不低于7.4。
2、在项目根目录执行命令：composer require elasticsearch/elasticsearch。
3、等待依赖下载并自动写入composer.json与vendor目录。
4、在PHP脚本中引入自动加载器：require 'vendor/autoload.php';。
二、配置Elasticsearch客户端连接参数
客户端需明确指定Elasticsearch集群的地址、端口、协议及可选的身份验证信息，才能建立稳定HTTP连接。
1、创建客户端配置数组，包含hosts键，值为含协议、主机名与端口的字符串数组。
2、若ES启用HTTPS，将http://替换为https://；若启用了Basic Auth，添加user和pass字段。
3、示例配置代码：$hosts = ['https://es-user:es-pass@localhost:9200'];
4、使用该配置初始化客户端：$client = \Elasticsearch\ClientBuilder::create()->setHosts($hosts)->build();
三、创建索引并映射基础字段结构
在执行搜索前，需确保目标索引存在并具备合理的字段类型定义，避免动态映射导致类型冲突或分词异常。
1、定义索引名称，例如product_index。
2、构造mapping数组，指定title字段为text类型并启用标准分词器，price为float类型。
3、调用indices()->create()方法传入索引名与body参数：$client->indices()->create(['index' => 'product_index', 'body' => $mapping]);
4、确认返回结果中acknowledged字段为true。
四、批量导入测试文档数据
向索引中注入结构化数据是验证搜索功能的前提，使用bulk API可显著提升写入效率并减少HTTP开销。
1、准备JSON格式的文档数组，每条文档前需附加action元数据行（如{"index":{"_index":"product_index"}}）。
2、将所有action与document合并为单个字符串，按换行符分割。
3、调用bulk接口：$client->bulk(['body' => $bulkBody]);
4、检查响应中的errors字段是否为false，确认无失败条目。
五、执行基础全文搜索查询
使用match查询可对text类型字段进行相关性评分检索，返回按_score降序排列的结果集，满足通用搜索需求。
1、构造搜索请求body，包含query节点，内嵌match子句，指定字段名与搜索关键词。
2、设置size参数控制返回文档数量，例如限制为10条。
3、调用search方法：$response = $client->search(['index' => 'product_index', 'body' => $searchBody]);
4、从$response['hits']['hits']中提取匹配文档数组，每个元素含_source原始数据与_score评分。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
