MongoDB\Client 是 PHP 8.5.5 下连接 MongoDB 最直接、最推荐的方式，前提是必须成功加载 mongodb 扩展（通过 php -m 验证），再用 composer require mongodb/mongodb 安装 SDK，然后 new MongoDB\Client("mongodb://localhost:27017") 即可连接，无需手动处理底层 Manager 类。
MongoDB\Client 是 PHP 8.5.5 下连接 MongoDB 最直接、最推荐的方式。只要扩展装对了、配置生效了，一行代码就能连上，不用手动处理底层 MongoDB\Driver\Manager。
确认 mongodb 扩展已加载（不是可选，是前提）
PHP 8.5.5 不自带 MongoDB 驱动，必须靠外部扩展。如果 extension=mongodb.so 没生效，MongoDB\Client 类根本不存在，会直接报 Fatal error: Uncaught Error: Class "MongoDB\Client" not found。
- 运行
php -m | grep mongodb，输出里要有mongodb才算加载成功 - 如果没看到，检查
php.ini路径是否正确（用php --ini查），确认extension=mongodb.so这行没被注释，且路径下真有这个文件 - Mac 上常见问题是
pecl install mongodb装完后mongodb.so被放到/usr/local/lib/php/pecl/20240801/这类带 PHP API 版本号的目录，而php.ini里写的路径可能不对 - Linux（如 Ubuntu）用
apt install php-mongodb更省事，它通常自动配好php.ini
用 MongoDB\Client 连接，别碰 MongoDB\Driver\Manager
MongoDB\Driver\Manager 是底层驱动入口，适合写 SDK 或做连接池定制；日常开发直接用 Composer 包封装好的 MongoDB\Client，更安全、更易读、自带重试和超时控制。
- 先装包：
composer require mongodb/mongodb（注意：不是ext-mongodb，那是扩展；这个是官方 SDK） - 连接字符串示例：
$client = new MongoDB\Client("mongodb://localhost:27017"); - 带认证：
$client = new MongoDB\Client("mongodb://user:pass@localhost:27017/mydb?authSource=admin"); - 加选项（比如 2 秒超时）：
$client = new MongoDB\Client("mongodb://localhost:27017", ["timeoutMS" => 2000]); - 别用过时的
MongoClient类——它早在 1.0 版 SDK 就被删了，PHP 8.5.5 下会直接报错
连接后立刻测试集合是否存在，避免静默失败
即使 MongoDB\Client 实例创建成功，也不代表数据库可写。MongoDB 默认“懒连接”，真正发请求才校验连通性。光 new 出来不操作，掩盖了网络或权限问题。
立即学习“PHP免费学习笔记（深入）”；
- 建议紧接着查一条数据：
$client->test->testcol->findOne(['x' => 1]); - 或用
listDatabases()（需 admin 权限）：$client->listDatabases(); - 所有操作都应套
try/catch，捕获MongoDB\Driver\Exception\ConnectionTimeoutException和MongoDB\Driver\Exception\AuthenticationException等具体异常，而不是笼统的Exception - 本地开发时，如果 MongoDB 服务根本没启动，
findOne()会卡满超时时间再抛异常，所以显式设connectTimeoutMS很关键
PHP 8.5.5 的兼容性注意点
PHP 8.5.5 对扩展要求更严，尤其涉及类型声明和错误处理。老项目升级后常在这里翻车。
-
mongodb扩展最低要求 PHP 7.4，但 PHP 8.5.5 下必须用mongodb1.22+（2025 年后发布），否则会出现Typed property MongoDB\BSON\UTCDateTime::$milliseconds must not be accessed before initialization类型错误 - Composer 包
mongodb/mongodb推荐用 1.20+，它内部做了 PHP 8.5 的类型适配，比如把array|object返回值统一为array - 别在连接字符串里写
ssl=true却不配 CA 证书——PHP 8.5.5 的 OpenSSL 层会直接拒绝握手，报SSL handshake failed，而不是降级到非加密连接 - Mac 上用 Homebrew 装的 PHP，常因 OpenSSL 版本不匹配导致 SSL 连接失败，此时要确保
openssl.cafile在php.ini中指向系统信任根证书路径（如/opt/homebrew/etc/openssl@3/cert.pem）
真正卡住人的地方，往往不是语法写错，而是扩展没加载、连接串少了个 ?authSource=admin、或者 PHP 和 mongodb 扩展版本不匹配——这些不会报明确提示，只会让 new MongoDB\Client 后的任何操作静默失败或超时。
