Elastica安装需对齐PHP与版本：PHP 8.0+用v8+，7.4用v7.3；v8+必须通过ConnectionPool或hosts数组配置连接，且需手动refresh索引才能立即查到新数据。
直接执行 composer require 就能装，但要注意 PHP 和 Elastica 版本对齐
新版 Elastica（v8+）只支持 PHP 8.0+，如果你用的是 PHP 7.4 或更早版本，composer require elastica/elastica 会报错或降级到 v7.x。v7.x 虽兼容 PHP 7.2+，但默认连接方式已弃用 Elastica\Client 的旧构造参数，改用 ConnectionPool 风格配置。
实操建议：
- 先运行
php -v确认当前 PHP 版本 - PHP 8.0+：直接运行
composer require elastica/elastica:^8 - PHP 7.4：显式指定
composer require elastica/elastica:^7.3（v7.4 开始要求 Elasticsearch 7.10+，v7.3 更稳） - 别依赖
composer require elastica/elastica不带版本——它可能拉下不兼容的预发布版
安装后必须手动配置连接，Elastica\Client 不再接受简单 host/port 数组
v8+ 彻底移除了 ['host' => '127.0.0.1', 'port' => 9200] 这种构造方式。现在必须传入 ConnectionPool 实例或配置数组，否则会抛出 TypeError: Argument 1 passed to Elastica\Client::__construct() must be of the type array or null。
常见写法（以 v8.2 为例）：
立即学习“PHP免费学习笔记（深入）”；
$client = new \Elastica\Client([
'hosts' => ['http://127.0.0.1:9200']
]);
注意点：
-
hosts是必须项，值为字符串数组；单节点也得包一层[] - 协议（
http://或https://）不能省，否则底层用http拼接，连不上 HTTPS 集群 - 如果 Elasticsearch 启用了 Basic Auth，要加
'headers' => ['Authorization' => 'Basic ...']，不能塞进 URL
自动加载没问题，但 IDE 可能报找不到类，需确认 autoload 是否生效
Composer 安装后，vendor/autoload.php 会自动注册 Elastica 命名空间。但如果在 CLI 下执行脚本时忘了 require 'vendor/autoload.php'，或在 Web 环境里路径不对，就会出现 Class 'Elastica\Client' not found。
排查步骤：
- 检查
vendor/elastica/elastica/src/Client.php是否真实存在 - 运行
composer dump-autoload -o强制刷新类映射（尤其改过composer.json后） - 在代码开头加
var_dump(class_exists(\Elastica\Client::class));快速验证自动加载是否就绪 - IDE 报错但运行正常？多半是未识别
vendor目录为源根，不是 Composer 问题
第一次写索引操作容易忽略 setRefresh，导致查不到刚插入的数据
Elasticsearch 默认是近实时搜索，新文档写入后最多 1 秒才可查。开发时习惯性用 $index->addDocuments($docs) 插完就查，常返回空结果。这不是 Elastica bug，而是 ES 默认刷新策略。
临时解决（仅限开发/测试）：
- 插入后调用
$index->refresh()强制刷新 - 或在添加文档时设
setRefresh(true)：$index->addDocuments($docs)->setRefresh(true);
- 生产环境别这么干——频繁刷新会拖慢写入吞吐，应靠业务逻辑容忍 1 秒延迟，或用
wait_for参数控制一致性
真正卡住人的地方往往不是安装，而是 v8 的连接初始化方式和 ES 自身的 refresh 行为混在一起，调试时容易来回怀疑是不是 Client 没连上。
