phpEnv 不支持 MongoDB 扩展自动安装，需为每个 PHP 版本手动编译启用：先确认版本及 php.ini 路径，再用对应版本的 pecl install mongodb，最后在 php.ini 中添加 extension=mongodb.so 并验证。
phpEnv 本身不直接支持 MongoDB 扩展的自动安装 —— 它不是像 laragon 或 XAMPP 那样内置扩展管理器的全栈环境，而是一个轻量级、面向 CLI 和多版本 PHP 切换的工具。你在 phpEnv 下装 MongoDB，本质是手动为每个 PHP 版本编译并启用 mongodb 扩展。
确认 phpEnv 管理的 PHP 版本和路径
phpEnv 默认不会修改系统级 php.ini，它通过符号链接切换不同版本的 php 可执行文件，每个版本有自己独立的配置目录。你必须先明确当前激活的版本：
phpenv version 查看当前版本（如 8.2.12）which php 确认二进制路径（通常是 ~/.phpenv/versions/8.2.12/bin/php）php --ini 找到加载的 php.ini 路径（注意：它可能指向 ~/.phpenv/versions/8.2.12/etc/php.ini，也可能没生成，需手动创建）
常见坑：很多人误以为 php --ini 显示 “Loaded Configuration File: (none)” 就跳过配置，结果扩展装了但不生效。这时你得手动创建 etc/php.ini 并确保它被读取。
立即学习“PHP免费学习笔记（深入）”；
用 pecl 为 phpEnv 的 PHP 版本安装 mongodb 扩展
pecl 命令必须指向当前 phpEnv 激活版本的 phpize 和 php-config，否则会编译失败或装到错误版本里。
进入对应版本目录：cd ~/.phpenv/versions/8.2.12
确保 bin/ 在 $PATH 前置位置（phpenv rehash 后通常已就绪）
运行：pecl install mongodb
安装成功后，会输出类似：installing /home/user/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-non-zts-20220829/mongodb.so
关键点：
- 不要直接运行系统级
pecl（比如 Ubuntu 自带的/usr/bin/pecl），它会绑定系统 PHP - 如果提示
phpize not found，说明该 PHP 版本编译时没带开发头文件，需重新用phpenv install --reinstall 8.2.12加上--enable-debug或确认构建时已含php-dev类依赖
手动启用 extension=mongodb.so 并验证
phpEnv 不会自动写 php.ini，你得自己加：
打开或创建：~/.phpenv/versions/8.2.12/etc/php.ini
在文件末尾添加：extension=mongodb.so
保存后，强制重载配置：phpenv rehash
然后验证：php -m | grep mongodb → 应输出 mongodbphp -r "var_dump(extension_loaded('mongodb'));" → 应返回 bool(true)
容易踩的坑：
-
php.ini路径写错（比如写成lib/下而非etc/） -
mongodb.so路径不对（pecl install输出的路径要和extension_dir匹配；若不匹配，需在php.ini中显式指定完整路径，如extension=/home/user/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-non-zts-20220829/mongodb.so） - 忘记对每个要用 MongoDB 的 PHP 版本重复上述流程（
phpenv shell 8.1.20后还得再装一遍）
连接测试：不要依赖 web 服务器，先跑 CLI
phpEnv 主要服务 CLI 场景，Web 服务（如 Nginx + PHP-FPM）通常绕过它。所以别急着配 Apache/Nginx，先确保 CLI 能连通：
写个测试脚本 test-mongo.php：
<?php
require_once __DIR__ . '/vendor/autoload.php'; // 如果用了 composer require mongodb/mongodb
$client = new MongoDB\Client('mongodb://127.0.0.1:27017');
var_dump($client->listDatabases());
运行：
php test-mongo.php
如果报 Class 'MongoDB\Client' not found，说明你只装了扩展，没装客户端库 —— mongodb 扩展提供底层驱动，但 MongoDB\Client 来自 Composer 包 mongodb/mongodb，两者缺一不可。
复杂点在于：你得区分清楚「扩展」和「客户端库」。前者是 PHP 内核级能力（让 new MongoDB\Client() 这类调用能真正发网络请求），后者只是语法糖封装。漏掉任一个，都会在不同阶段失败。
