PHP 8.2 安装 MongoDB 扩展必须严格匹配版本、编译器（VC15/VC16）、TS/NTS 及 phpize/php-config 路径，mongodb-1.15 是最后支持 PHP 8.2 的 vc15 版本，但官方 PHP 8.2 默认为 vc16，需降级或换用 1.19+；查询语法未变，但驱动行为更严格，如 replicaSet 参数须小写、strict_types 影响类型校验、异常处理需捕获 Throwable。
PHP 8.2 安装 mongodb 扩展 1.15 版本是可行的，但必须手动编译或下载匹配的二进制 DLL；而 PHP 7.4 到 8.2 的 MongoDB 查询写法没有本质变更，真正变化的是驱动行为、错误处理和类型约束，不是语法本身。
phpize 和 php-config 必须严格指向 PHP 8.2
装 mongodb 扩展时最容易出错的地方，就是用了 PHP 7.4 的构建工具去编译 PHP 8.2 的扩展。哪怕 configure 成功，运行时也会报 undefined symbol: zend_string_init 或直接段错误。
- 确认当前 phpize 是 PHP 8.2 的：
which phpize应输出类似/usr/local/php82/bin/phpize，不是/usr/bin/phpize（那是系统默认的，大概率是 7.4） - 同理，
which php-config必须与 phpize 同目录，且php-config --version输出 8.2.x - 进入 mongodb 扩展源码目录后，必须显式指定：
./configure --with-php-config=/usr/local/php82/bin/php-config - 编译完用
ldd modules/mongodb.so | grep php检查是否只链接了 PHP 8.2 的libphp.so，没混入旧版本符号
Windows 下装 mongodb-1.15 需核对 TS/NTS + VC 版本
PHP 8.2 官方 Windows 构建使用 VS 2019（vc16），而 mongodb-1.15 是最后支持 PHP 7.4–8.2 的稳定版，但它只提供 vc15（VS 2017）编译的二进制。如果你用的是官方 php.net 下载的 PHP 8.2（vc16），直接放 php_mongodb.dll 会报 VCRUNTIME140_1.dll 缺失或模块加载失败。
- 要么降级到 PHP 8.2 vc15 版（如某些第三方包），要么改用 mongodb-1.19+（已支持 vc16）
- 检查你的 PHP 是 TS（线程安全）还是 NTS：运行
php -i | grep "Thread Safety"，输出enabled就是 TS，需匹配ts后缀的 DLL - DLL 必须放在
extension_dir指向的目录下，且php.ini中写的是extension=php_mongodb.dll（不是extension=mongodb） - 重启 Web 服务后，用
php --ri mongodb确认输出里有PHP Version => 8.2.x，不是7.4.x
PHP 7.4 升级到 8.2 后 MongoDB 查询没变，但行为更严格
像 $collection->find(['name' => 'foo']) 或 $collection->insertOne(['x' => 1]) 这类基本写法完全没变。所谓“写法变更”其实是底层驱动和 PHP 引擎协同导致的隐性差异：
立即学习“PHP免费学习笔记（深入）”；
-
new MongoDB\Driver\Manager()的连接字符串中，replicaSet参数在 PHP 8.2 + mongodb-1.15 下必须显式小写，旧写法ReplicaSet会静默忽略 - PHP 8.2 默认开启
strict_types=1，如果项目里有declare(strict_types=1);，传给find()的选项数组里不能有 string 键对应 int 值（如['limit' => '10']），会触发TypeError -
toArray()返回的数组键现在严格保持 BSON 文档原始顺序（PHP 7.4 是杂乱的），依赖 key 顺序的代码可能出问题 - 未捕获的
RuntimeException（如连接超时）在 PHP 8.2 中默认转为UnhandledMatchError或ValueError，需统一用try/catch (Throwable $e)包裹
最常被忽略的是：mongodb 扩展本身不提供数据库服务，PHP 8.2 能连上只是说明扩展加载成功；真正执行查询前，必须确保 MongoDB Server（如 6.0/7.0）正在运行，且连接 URL 中的端口、认证、TLS 设置与服务端完全一致——这个环节出错，错误信息往往藏在 php-fpm 日志里，而不是 phpinfo() 页面上。
