PHP 8.3 必须安装 v1.19.0+ mongodb 扩展（非废弃 mongo），并搭配 composer require mongodb/mongodb 库；连接字符串需含 ?retryWrites=true，认证库名须正确，_id 需用 ObjectId 实例，Client 类依赖 autoload.php 加载。
能用，但必须装 mongodb 扩展（不是 mongo），且连接字符串要带 ?retryWrites=true。 PHP 8.3 完全兼容官方 mongodb 扩展（v1.20+），但旧版扩展或错误配置会导致 Class 'MongoDB\Client' not found 或写操作静默失败。
怎么确认 mongodb 扩展已装对版本
PHP 8.3 要求 mongodb 扩展最低为 v1.19.0（推荐 v1.20.0+）。装错会报错或功能缺失：
- 运行
php -v确认是 8.3.x（如 8.3.7） - 执行
php -m | grep mongodb，有输出才说明扩展已加载；没输出就还没装好 - 检查扩展版本：
php --ri mongodb，看输出里Version => 1.20.0这类信息 - Windows 用户特别注意：必须下载匹配
PHP 8.3 TS/NTS x64/x86的php_mongodb.dll，混用会直接崩溃
new MongoDB\Client() 报 Class not found 怎么办
这个错不是 PHP 版本问题，而是两类依赖没配齐：
-
MongoDB\Client类来自mongodb/mongodbComposer 包，不是扩展自带的 —— 光装mongodb扩展还不够 - 必须先运行
composer require mongodb/mongodb，再require_once 'vendor/autoload.php' - 如果只用底层驱动（比如要控制连接池或调试超时），就别碰
Client，直接用MongoDB\Driver\Manager - 漏了
autoload.php或 Composer 自动加载失效时，Client类一定找不到
连接成功但 insert() 没反应、find() 返回空游标
这是 PHP 8.3 + MongoDB 驱动最常见的“假成功”现象，根源在连接参数和数据格式：
立即学习“PHP免费学习笔记（深入）”；
- 连接字符串必须含
?retryWrites=true，否则副本集或 Atlas 上写操作会被拒绝（不报错，但数据不入库） - 认证数据库名要写对：带密码时，
mongodb://u:p@h:27017/admin?retryWrites=true中的admin是认证库，不是业务库 -
find()返回的是MongoDB\Driver\Cursor，不能直接print_r查看内容，得foreach ($cursor as $doc)或调$cursor->toArray() - 插入文档里的
_id如果是字符串，MongoDB 不会自动转成ObjectId；要生成新 ID，得用new MongoDB\BSON\ObjectId()
为什么用 Manager 而不是 Client 更容易踩坑
直接用 MongoDB\Driver\Manager 看似轻量，但实际开发中隐藏成本更高：
- 所有操作都得手动拼完整命名空间，比如
'mydb.users'，漏写数据库名就抛InvalidArgumentException - 查数据必须组合
MongoDB\Driver\Query+executeQuery()，不能链式调用，代码冗长 - 没有内置的
insertOne()/updateMany()，增删改都得走BulkWrite，单条插入也得$bulk->insert($doc) - 错误类型分散：
ConnectionTimeoutException、RuntimeException、InvalidArgumentException得分别 catch，不如Client统一抛MongoDB\Driver\Exception\Exception
真正容易被忽略的是：PHP 8.3 默认启用 opcache.preload 时，如果 mongodb 扩展没在预加载阶段就初始化，某些 Swoole 或 RoadRunner 场景下首次请求会卡住或报错 —— 这类问题不会出现在 CLI 或普通 FPM 下，但上线后突然出问题很难定位。
