小皮面板安装 MongoDB 扩展只需三步：先按 PHP 版本下载对应的 php_mongodb.dll（Linux 下编译出 mongodb.so），把文件放进当前 PHP 版本的 ext 目录，在该版本的 php.ini 里加上 extension=php_mongodb.dll，重启 PHP 后用 php -m 验证。注意 PHP 5.6 之后只能使用 mongodb 扩展，老的 mongo 扩展在 PHP 7 及以上无法加载。
小皮面板装 MongoDB 扩展要分几步？
结论：分「匹配版本 → 放入 ext 目录 → 写 php.ini → 重启 PHP → 验证」五步，其中版本匹配是最容易出错的环节。
小皮面板（Windows 版即 phpStudy Pro，默认安装在 D:\phpstudy_pro）只负责帮你挂载扩展文件，扩展本体是 PECL 上的 mongodb，必须手动下载或编译。面板的「软件管理 → PHP → 设置 → 扩展」列表扫描的就是该 PHP 目录下的 ext 文件夹，把 dll 放进去后通常会自动出现 mongodb 勾选项，勾选等价于在 php.ini 里写入 extension。
另外要区分两件事：MongoDB 扩展只是 PHP 与数据库通信的驱动，MongoDB 服务端（Community Server）需要单独安装，默认监听 27017 端口。
怎么确认该下哪个版本的 MongoDB 扩展？
结论：看三件事——PHP 版本、线程安全类型（TS/NTS）、编译器版本（vc15/vs16），三者都对上才能加载成功。
小皮面板的 PHP 目录名直接给出答案，例如 php7.4.3nts：7.4.3 是 PHP 版本，nts 表示 Non Thread Safe（非线程安全，Nginx 环境用这个），没有 nts 后缀才是 TS。编译器对应关系：PHP 7.3 及以下用 vc15，PHP 7.4 及以上用 vs16。
下载地址是 windows.php.net/downloads/pecl/releases/mongodb/，文件名形如 php_mongodb-1.15.0-7.4-nts-vs16-x64.zip。版本匹配上，mongodb 1.15.x 覆盖 PHP 7.2～8.2，PHP 8.3 需要 1.16 以上。位数也要一致，面板装的是 64 位 PHP，就别拿 32 位 dll。
Windows 版小皮面板怎么给 PHP 挂上 mongodb 扩展？
结论：dll 放对目录 + php.ini 里加一行，两条都对就不会报错。
- 面板 → 软件管理，确认正在运行的 PHP 版本号；
- 解压下载包，取出
php_mongodb.dll，复制到 D:\phpstudy_pro\Extensions\php\php7.4.3nts\ext\；
- 用编辑器打开同目录下的
php.ini，在文件末尾加一行 extension=php_mongodb.dll；
- 确认
extension_dir 指向的是绝对路径的 ext 目录（面板默认已配好，别手改）；
- 在面板里重启对应 PHP 或重启网站。
注意：一台面板上通常装了多个 PHP 版本，每个版本有独立的 php.ini，改错文件是最高频的失误。以 phpinfo() 里的 Loaded Configuration File 那一行为准。
Linux 小皮面板怎么装 mongodb 扩展？
结论：Linux 版没有现成 dll 可拷，必须用 phpize 编译，编译产物是 mongodb.so。
以面板装的 PHP 7.4 为例，路径一般在 /www/server/php/74/：
yum install -y gcc make autoconf
wget https://pecl.php.net/get/mongodb-1.15.0.tgz
tar -zxvf mongodb-1.15.0.tgz && cd mongodb-1.15.0
/www/server/php/74/bin/phpize
./configure --with-php-config=/www/server/php/74/bin/php-config
make && make install
编译完成后在对应 php.ini 里加 extension=mongodb.so，再重启 PHP-FPM。如果服务端已装好 pecl，直接 pecl install mongodb 更快，但它可能装到系统自带 PHP 的目录，务必确认装的是面板那个 PHP。
装完怎么验证扩展真的生效？
结论：命令行和 phpinfo 两种核对方式都要看一次，前者看扩展是否加载，后者看你改对了哪个 ini。
命令行执行 php -m | grep mongodb，或用 Windows 的 php -m | findstr mongodb。页面方式创建一个 phpinfo() 文件，搜索 mongodb 区块，同时确认 Loaded Configuration File 路径与你编辑的一致。
判断「扩展能连库」的最小测试代码：
<?php
$m = new MongoDB\Driver\Manager("mongodb://127.0.0.1:27017");
$cursor = $m->executeQuery("test.demo", new MongoDB\Driver\Query([]));
echo "connected";
连接串里建议写 127.0.0.1 而不是 localhost，避免 IPv6 解析到 ::1 而服务端只监听 IPv4 时连不上。另外扩展只提供底层驱动，日常增删改查推荐再用 Composer 装 mongodb/mongodb 库，否则你面对的是原始 Cursor 和 BSON 对象。
常见报错怎么排查？
结论：加载失败八成是版本、位数或 ini 三选一出错，而不是扩展本身有问题。
- PHP 启动报「不是有效的 Win32 应用程序」：位数或 TS/NTS 选错，换对应包即可；
phpinfo 里完全找不到：改错了 php.ini，或 extension_dir 没指向 ext 目录；- 报
Class 'MongoClient' not found：用的是 PHP 5 时代的 mongo 扩展写法，PHP 7 以后要改成 MongoDB\Driver\Manager；
- 扩展加载成功但连不上：检查 MongoDB 服务是否启动（Windows 用
services.msc 看 MongoDB 服务）、6.0 之后默认只绑定 127.0.0.1，远程访问要改 mongod.conf 的 bindIp，同时别忘了在数据库里建账号并开启 authorization。
全文要点归一句：Windows 版靠「对版本的 dll + 对应 php.ini 一行配置」，Linux 版靠「phpize 编译出 mongodb.so + 重启 FPM」，验证一律以 php -m 输出的加载结果为准，而不是看面板的勾选框。
