phpEnv安装MeiliSearch扩展 phpEnv PHP搜索库-php教程-PHP中文网

phpenv不提供meilisearch扩展，需用composer安装纯php sdk：composer require meilisearch/meilisearch-php；确保curl和json模块启用，并确认meilisearch服务已运行且配置正确。

phpenv安装meilisearch扩展 phpenv php搜索库

phpEnv 本身不是 PHP 扩展，也不提供 MeiliSearch 的原生 PHP 扩展（比如 meilisearch.so）。它只是一个 Windows 下的 PHP 多版本环境管理工具，类似 phpenv（macOS/Linux），不负责安装搜索引擎服务或客户端库。

你真正需要的，是「在 phpEnv 管理的 PHP 环境中，让 PHP 代码能调用 MeiliSearch」——这靠的是 Composer 安装的纯 PHP SDK，不是 C 扩展。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

MeiliSearch 官方只维护一个 PHP 客户端：纯 PHP 实现，基于 GuzzleHttp 或 PSR-18 兼容 HTTP 客户端
它不依赖任何 PHP C 扩展（不需要编译 .so/.dll），只要你的 phpEnv 环境里有 cURL 和 JSON 模块（默认已启用）就能跑
运行前确认：
- php -m | findstr curl（Windows）或 php -m | grep curl（确保输出 curl）
- php -m | findstr json（同理，json 必须存在）
- php --ini 查看当前生效的 php.ini 路径，避免误配了另一个 PHP 版本

phpEnv 切换 PHP 版本后，composer 可能仍指向旧版 PHP 的 bin 目录，导致 composer require 装到错的 vendor/ 里
→ 解决：用完整路径运行，例如 C:\phpenv\php74\php.exe C:\phpenv\php74\composer.phar require meilisearch/meilisearch-php
MeiliSearch 服务没起来，或地址/端口/密钥配错
→ 默认是 @#@#@#@#@#@#@#@#@#@0，若启用了主密钥（MEILI_MASTER_KEY），客户端初始化时必须传：
```
$client = new \MeiliSearch\Client('https://www.php.cn/link/2c97e3fb21c2d302412609ccd0804314', 'your-master-key');
```

Laravel Scout 集成时，scout.php 配置里的 meilisearch 键名写成 meilisearchs 或漏掉 host 字段
→ 正确写法：

'meilisearch' => [
    'host' => 'https://www.php.cn/link/2c97e3fb21c2d302412609ccd0804314',
    'key' => env('MEILISEARCH_KEY', ''),
],

meilisearch-php ^0.24 要求 guzzlehttp/guzzle ^7.5，但 phpEnv 下某些老项目（如 Laravel 8）自带 guzzlehttp/guzzle ^6.5
→ 不要硬升级 Guzzle，改用兼容版 SDK：
- 锁定 meilisearch-php 为 0.19.0（2026 年 4 月仍稳定可用）
- 执行：composer require meilisearch/meilisearch-php:0.19.0 guzzlehttp/guzzle:^6.5
这个组合在 phpEnv + PHP 7.4 / 8.0 下实测无报错。