phpEnv 不提供 Solr 扩展安装能力，因其仅为 PHP 版本管理工具，不集成 PECL 扩展构建逻辑；Solr 扩展需手动编译，且严格依赖当前 PHP 版本的 ABI（主版本、ZTS/NTS、debug 模式等）。
phpEnv 本身不提供 Solr 扩展安装能力，它只是 PHP 多版本管理工具；Solr 扩展必须手动编译安装，并确保与当前 phpEnv 切换的 PHP 版本 ABI 兼容。
为什么 phpEnv 没有 solr.so？
phpEnv 是基于 php-build 的轻量级 PHP 版本切换工具，不集成 PECL 扩展安装逻辑。它只负责编译/下载指定 PHP 二进制，不处理扩展依赖（如 libcurl、libxml2）或 pecl install 流程。
- Solr 扩展（
solr）是 PECL 包，需单独构建，且对 PHP 主版本（7.4/8.1/8.2…）、ZTS/NTS、debug/non-debug 模式高度敏感 - phpEnv 切换 PHP 后，
php -v显示的版本可能和pecl默认绑定的 PHP 不一致，导致pecl install solr编译失败或生成错位的.so - Windows 下 phpEnv（如 Laragon 封装版）通常预置
solr.dll，但 Linux/macOS 必须源码编译
在 phpEnv 环境下正确安装 solr 扩展的步骤
以当前 phpEnv 激活的 PHP 为例（假设为 phpenv shell 8.2）：
- 确认 PHP 配置路径：
php-config --extension-dir—— 记下输出路径，如/home/user/.phpenv/versions/8.2.0/lib/php/extensions/no-debug-zts-20220829/ - 安装编译依赖：
sudo apt install libcurl4-openssl-dev libxml2-dev（Ubuntu/Debian）或brew install libcurl libxml2（macOS） - 用当前 PHP 的
phpize启动构建：~/.phpenv/versions/8.2.0/bin/phpize - 配置时显式指定 PHP 路径：
./configure --with-php-config=~/.phpenv/versions/8.2.0/bin/php-config - 编译安装：
make && make install，成功后会提示Installing shared extensions: .../no-debug-zts-20220829/ - 编辑该 PHP 版本专属的
php.ini（非系统全局）：~/.phpenv/versions/8.2.0/etc/php.ini，添加：extension=solr.so - 验证：
phpenv shell 8.2 && php -m | grep solr应输出solr
常见错误：Extension 'solr' not found 或 Segmentation fault
这两个错误几乎都源于 ABI 不匹配：
立即学习“PHP免费学习笔记（深入）”；
-
PHP Warning: PHP Startup: Unable to load dynamic library 'solr.so'→ 检查extension_dir是否指向当前 PHP 版本的扩展目录，而非其他版本（如 8.1 的no-debug-zts-20210902） -
Segmentation fault (core dumped)→ 说明solr.so是用不同 ZTS/NTS 或 debug 模式编译的，必须重新用当前phpize和php-config构建 -
undefined symbol: curl_easy_setopt→libcurl版本过低或未静态链接，重装libcurl4-openssl-dev并清理make clean后重试
solr 扩展启用后，如何快速验证连接与查询
别急着写业务逻辑，先用最小代码确认客户端通路：
<?php
$client = new SolrClient([
'hostname' => 'localhost',
'port' => 8983,
'path' => '/solr/',
'core' => 'mycore'
]);
try {
$ping = $client->ping();
echo "✅ Solr ping OK\n";
$query = new SolrQuery('*:*');
$query->setStart(0)->setRows(1);
$response = $client->query($query);
echo "✅ Query returned " . $response->getResponse()->getHttpStatus() . "\n";
} catch (SolrException $e) {
echo "❌ " . $e->getMessage() . "\n";
}
注意：SolrClient 构造参数中 core 是可选的，若 Solr 4.0+ 使用默认 core，可省略；但路径 /solr/ 末尾斜杠不能少，否则返回 404。
真正麻烦的从来不是装上扩展，而是让 SolrClient 实例能稳定复用、正确处理中文分词、避免超时中断——这些得在实际请求里调参，而不是靠 phpEnv 命令行解决。
