PHP环境中的搜索引擎：Elasticsearch与PHP环境的集成配置-php教程-PHP中文网

php 集成 elasticsearch 需三步：部署 es 服务（windows 下手动安装并启用 https）、安装匹配版本官方 php 客户端（≥php 8.1，composer 安装 elasticsearch/elasticsearch:^8.x）、正确配置连接（含 ssl 验证关闭、basic auth 或 api key）。中文搜索必须安装 ik 插件并显式指定 ik_smart 分词器。

php环境中的搜索引擎：elasticsearch与php环境的集成配置

PHP 环境本身不带搜索引擎能力，Elasticsearch 必须单独部署并由 PHP 主动连接。集成核心就三件事：ES 服务跑起来、PHP 客户端装对、连接参数配准——漏一项就会卡在 ClientBuilder::create()->build() 静默失败或报 cURL error 7、Connection refused、SSL certificate problem 这类错误。

确认 Elasticsearch 服务已就绪

phpEnv 是 Windows 下本地套件（类似 XAMPP），不附带 ES。你得手动下载安装：

去官网下载对应版本 ZIP 包（如 elasticsearch-8.15.5-windows-x86_64.zip），解压后运行 bin\elasticsearch.bat
ES 8.x 默认启用 HTTPS + Basic Auth，启动后检查是否监听 https://localhost:9200（注意是 https，不是 http）
浏览器或命令行执行：curl -k -u elastic:你的密码 -X GET "https://localhost:9200/"，返回含 "version" 的 JSON 才算通
开发阶段可临时关安全：编辑 config/elasticsearch.yml，加一行 xpack.security.enabled: false，再重启

安装匹配的官方 PHP 客户端

别用旧包、别手写 cURL，直接上官方 elasticsearch/elasticsearch：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

PHP 版本需 ≥ 8.1（ES 8.x 客户端硬性要求），用 php -v 确认
执行：composer require elasticsearch/elasticsearch:^8.18（版本号必须和你装的 ES 主版本一致，比如 ES 是 8.18.0，客户端就得是 ^8.18）
装完检查 vendor/elasticsearch/elasticsearch/CHANGELOG.md，确认支持标称的 ES 版本
避免踩坑：^1.0、dev-master 已废弃，混用会报 406 Not Acceptable 或 DSL 解析失败

PHP 中正确初始化连接

ES 8+ 强制 HTTPS 和认证，phpEnv 默认不信任自签名证书，也不传凭据——必须显式配置：

基础连接代码示例：

$client = \Elasticsearch\ClientBuilder::create()
  ->setHosts(['https://localhost:9200'])
  ->setSSLVerification(false) // 仅限本地开发！生产必须配 CA
  ->setBasicAuthentication('elastic', '你的密码') // 密码见启动日志或 elasticsearch-reset-password
  ->build();

调用 $client->info() 测试，返回 200 且含 version.number 才算真正连通
若用 API Key 认证，改用 ->setApiKey(['id' => 'xxx', 'api_key' => 'yyy'])
超时默认 30 秒，网络慢可加：->setConnectionPool(\Elasticsearch\ConnectionPool\StaticConnectionPool::class, ['connectionPoolParams' => ['maxConnections' => 10']])

中文搜索必须配 mapping 和分词器

不设 mapping 就直接写入，ES 会按默认 standard 分词器处理——对中文完全无效，搜不到是常态：

先装 IK 插件：bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v8.12.2/elasticsearch-analysis-ik-8.12.2.zip（版本号要和 ES 一致）
建索引时明确指定中文分词器：

$params = [
  'index' => 'article',
  'body' => [
    'mappings' => [
      'properties' => [
        'title' => ['type' => 'text', 'analyzer' => 'ik_smart'],
        'content' => ['type' => 'text', 'analyzer' => 'ik_smart'],
        'status' => ['type' => 'keyword']
      ]
    ]
  ]
];
$client->indices()->create($params);