PHP连接MongoDB必须使用官方mongodb扩展（非已废弃的mongo扩展），通过MongoDB\Driver\Manager建立连接，执行查询需用MongoDB\Driver\Query和executeQuery()，插入需用MongoDB\Driver\BulkWrite；若要使用MongoDB\Client等高级API，须额外安装mongodb/mongodb库。
PHP 连 MongoDB 不是靠 mysqli 或 PDO，必须用官方 mongodb 扩展（不是已废弃的 mongo 扩展）。
确认装的是 mongodb 扩展，不是 mongo
旧版 mongo 扩展在 PHP 7.0+ 已彻底移除，强行装会报 Class 'MongoClient' not found。现在唯一支持的是 mongodb 扩展（由 mongodb/mongo-php-driver 提供）。
- 检查是否启用：
php -m | grep mongodb（Linux/macOS）或查看phpinfo()中是否有mongodb模块 - 没装？用
pecl install mongodb（需先配好phpize环境），然后在php.ini加extension=mongodb - Windows 用户直接下载对应 PHP 版本和线程安全（TS/NTS）的
php_mongodb.dll，丢进ext/并在php.ini启用
用 MongoDB\Driver\Manager 建连接，别碰 MongoDB\Client（除非你用了官方库）
原生 PHP 不自带 MongoDB\Client 类——那是 mongodb/mongodb 官方封装库（基于 mongodb 扩展）提供的。纯扩展只提供底层驱动类。
- 最简连接（无认证）：
$manager = new MongoDB\Driver\Manager('mongodb://127.0.0.1:27017'); - 带认证：
$manager = new MongoDB\Driver\Manager('mongodb://user:pass@127.0.0.1:27017/admin');（注意/admin是认证数据库） - 连接失败时抛
MongoDB\Driver\Exception\ConnectionTimeoutException等异常，必须try/catch，不能靠@抑制
执行查询得靠 MongoDB\Driver\Query + $manager->executeQuery()
没有 mysql_query() 那种一行执行方式。所有操作都要手动构造查询对象、指定数据库和集合名。
立即学习“PHP免费学习笔记（深入）”；
- 查一条：
$query = new MongoDB\Driver\Query(['name' => 'Alice']); $cursor = $manager->executeQuery('mydb.users', $query); - 结果是
MongoDB\Driver\Cursor，遍历用foreach ($cursor as $doc) { ... }，$doc是 PHP 数组（含ObjectId等特殊类型） - 插入要手动构造
MongoDB\Driver\BulkWrite对象，再调$manager->executeBulkWrite()；不支持单条insert()方法 - 别把 JSON 字符串直接传给
Query构造函数——它只接受 PHP 数组，否则会静默失败或类型错乱
如果要用 MongoDB\Client 和链式调用，得额外装 mongodb/mongodb 库
这是社区广泛使用的 ODM 封装层，让写法接近 ORM，但它是纯 PHP 实现，依赖底层 mongodb 扩展。
- 安装：
composer require mongodb/mongodb - 连接：
$client = new MongoDB\Client('mongodb://127.0.0.1:27017'); - 查数据：
$collection = $client->selectCollection('mydb', 'users'); $result = $collection->find(['status' => 'active']); - 注意：这个
$result是MongoDB\Model\BSONDocument迭代器，转数组要$doc->getArrayCopy()，不是直接当数组用
真正容易卡住的地方是错误类型混用——比如把 new MongoDB\Driver\Manager 当成 MongoDB\Client 用，或者在没装扩展的情况下 composer require 了库却以为万事大吉。连通性验证务必从 php -m 和一个最简 new Manager() 开始。
