phpenv不提供Meilisearch扩展，因其是独立HTTP服务，PHP端仅通过meilisearch-php SDK调用API；需先用phpenv切换PHP版本，再用Composer安装SDK并启动Meilisearch服务。
phpenv 不提供、也不需要安装 “Meilisearch 扩展”——MeiliSearch 是一个独立的 HTTP 服务，PHP 端只通过 SDK（即 meilisearch/meilisearch-php Composer 包）调用其 API，不是 PHP 扩展（.so 或 .dll）。
为什么你搜不到 “phpenv install meilisearch”？
因为 phpenv 只管理 PHP 解释器本身（二进制、配置、扩展加载），它不处理第三方 SDK 或服务客户端。所谓 “Meilisearch PHP 客户端” 是纯 PHP 类库，和 curl、json 这类内置扩展性质完全不同。
常见误解来源：
- 把
pecl install meilisearch当真了（实际不存在这个 PECL 包） - 看到
meilisearch-php误以为是像redis那样的 C 扩展 - 在
phpenv文档里搜 “meilisearch”，结果为空，进而怀疑安装方式错了
正确集成 Meilisearch 的三步实操
前提是已用 phpenv 切换到目标 PHP 版本（如 phpenv local 8.2.0），且项目根目录有 composer.json：
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer require meilisearch/meilisearch-php guzzlehttp/guzzle http-interop/http-factory-guzzle:^1.0 - 确认
php -m | grep curl有输出（meilisearch-php依赖 cURL，不是可选） - 初始化客户端时，URL 和密钥必须匹配你本地或远程 Meilisearch 实例：
$client = new \MeiliSearch\Client('http://127.0.0.1:7700', 'masterKey'); - 若用 Laravel，注意
guzzlehttp/guzzle版本冲突：Laravel 8 默认带 Guzzle 7，而新版meilisearch-php要求 Guzzle 7.5+；若报Class GuzzleHttp\Client not found，先composer update guzzlehttp/guzzle
phpenv 下容易踩的坑：PHP 版本与 SDK 兼容性
meilisearch/meilisearch-php 自 0.24.0 起要求 PHP ≥ 8.0；如果你用 phpenv global 7.4.33，composer require 会直接失败并提示 Your requirements could not be resolved。
解决路径很明确：
- 查 SDK 支持表：访问 GitHub README 的 Compatibility 小节，确认你要用的 SDK 版本支持当前 PHP
- 降级 SDK：例如 PHP 7.4 必须用
composer require meilisearch/meilisearch-php:^0.19.0 - 升级 PHP：用
phpenv install 8.1.28+phpenv local 8.1.28，再装最新 SDK - 别忽略
http-interop/http-factory-guzzle：这个包在 PHP 7.4 下需锁定^1.0，PHP 8+ 可用^2.0，混用会触发ArgumentCountError
验证是否真连上了 Meilisearch？别只看 new Client() 不报错
构造 Client 实例只是初始化 HTTP 客户端，并不发起网络请求。真正校验连接，得调一次 API：
$client = new \MeiliSearch\Client('http://127.0.0.1:7700', 'wrong-key');
try {
$client->version();
} catch (\MeiliSearch\Exceptions\HTTPRequestException $e) {
// 401 Unauthorized → 密钥错
// 404 → URL 错（比如端口不是 7700）
// Connection refused → Meilisearch 没启动
}
本地启动 Meilisearch 最简命令：meilisearch --master-key=masterKey（确保已下载二进制或用 Docker 启动）。没这步，SDK 再对也查不到数据。
