PECL安装mongodb是PHP 8.2下最直接推荐方式，需先确保pecl、phpize、php-config及编译工具可用；安装后必须手动或自动在php.ini中添加extension=mongodb.so并重启服务，再用php -m | grep mongodb验证CLI生效。
pecl install mongodb 是 PHP 8.2 环境下安装 MongoDB 驱动最直接、最推荐的方式，前提是系统已具备编译和扩展管理能力。它默认安装的是当前稳定版 mongodb 扩展（非已废弃的 mongo），兼容 PHP 8.2+，且自动适配大多数 Linux/macOS 发行版。
PECL 安装前必须确认的几件事
跳过这步容易卡在“command not found”或编译失败：
-
pecl命令本身必须可用 —— 若报错bash: pecl: command not found，说明缺少php-pear包（Ubuntu/Debian）或php-pear+php-devel（CentOS/RHEL）； -
phpize和php-config必须存在 —— 它们属于php-dev（Debian系）或php-devel（RHEL系），缺一则pecl install会中途退出并提示 “Cannot find autoconf” 或 “configure: error: Cannot find php-config”； - 系统需预装
autoconf、make、gcc—— Ubuntu 上执行sudo apt install autoconf make gcc即可；macOS 用户若用 Homebrew，需先运行brew install autoconf automake libtool； - 确保你操作的是目标 PHP 版本（如 PHP 8.2）的
pecl—— 运行which pecl和pecl -V，再核对php -v输出是否一致；多个 PHP 版本共存时，可能要用/usr/bin/php8.2-pecl或类似路径。
执行 pecl install mongodb 后的关键动作
PECL 安装完只是把 mongodb.so 编译好放进扩展目录，并不自动启用。常见疏漏点：
- 安装过程末尾会问：
Do you want to add this extension to your php.ini? [yes] :—— 务必输yes，否则不会写入配置； - 如果没选 yes，就得手动编辑
php.ini：先用php --ini | grep "Loaded Configuration File"找到生效的配置文件路径，再在文件末尾加一行extension=mongodb.so； - 注意不是
extension=mongo.so——mongo是 PHP 5.x 时代的旧驱动，PHP 8.2 下加载会报错PHP Warning: PHP Startup: Unable to load dynamic library 'mongo.so'； - 某些环境（如 Docker 或自编译 PHP）的
extension_dir路径未设或指向错误，导致 PHP 找不到mongodb.so；可运行php -i | grep extension_dir检查，必要时在php.ini中显式声明，例如：extension_dir = "/usr/lib/php/20220829"（具体值以php -i输出为准）。
验证是否真正生效：别只信 phpinfo()
phpinfo() 页面能看到 mongodb 模块，不代表 CLI 或 Web SAPI（如 Apache/Nginx）都加载了 —— 它们可能用不同 php.ini：
- CLI 下验证：
php -m | grep mongodb—— 有输出即 CLI 生效； - Web 环境验证：新建
test.php，内容为<?php var_dump(extension_loaded('mongodb'));，通过浏览器访问；返回bool(true)才算 Web 侧成功； - 若 CLI 成功但 Web 失败，大概率是 Web 服务器用的不是同一个
php.ini—— 比如 Apache 使用/etc/php/8.2/apache2/php.ini，而 CLI 用的是/etc/php/8.2/cli/php.ini，需分别配置； - 重启服务不可省：
sudo systemctl restart apache2（Apache）或sudo systemctl restart php8.2-fpm && sudo systemctl restart nginx（Nginx + FPM）。
Windows 下不能用 pecl install？换二进制 DLL
Windows 没有 pecl install 编译能力，必须手动下载匹配的 php_mongodb.dll：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -v看版本（如PHP 8.2.10），再运行php -i | findstr "Architecture Thread Safety"（Win）或php -i | grep -E "(Architecture|Thread)"（macOS/Linux）—— 明确是 x64 还是 x86、TS（线程安全）还是 NTS； - 去 https://www.php.cn/link/51d3a6f35b8dfe611ff24214c8ef79d1 下载对应版本 ZIP（如
mongodb-1.19.3-8.2-nts-vc17-x64.zip）； - 解压后把
php_mongodb.dll放进 PHP 的ext目录（如C:\php\ext），然后在php.ini里写extension=php_mongodb.dll； - 注意：Windows 下扩展名必须带
.dll，且路径中不能有中文或空格，否则加载失败无提示。
extension_dir 路径失效 —— 尤其当 PHP 是从源码编译、或通过第三方包管理器（如 XAMPP、WAMP）安装时，so 文件位置和 php.ini 加载顺序都可能偏离预期。动手前先跑一遍 php --ini 和 php -i | grep -A5 "Configure Command"，比盲目重装更省时间。 
