
本文讲解在仅使用原生 ext-mongodb 扩展(即 \MongoDB\Driver\Manager)时,如何手动执行命令获取数据库列表,并对比说明为何推荐升级至更高层的 MongoDB\Client。
本文讲解在仅使用原生 `ext-mongodb` 扩展(即 `\mongodb\driver\manager`)时,如何手动执行命令获取数据库列表,并对比说明为何推荐升级至更高层的 `mongodb\client`。
\MongoDB\Driver\Manager 是 PHP MongoDB 驱动扩展(ext-mongodb)提供的底层连接管理器,它直接封装 C 驱动,不包含高级操作接口(如 listDatabases()、selectCollection() 等)。这些便捷方法由上层的 MongoDB PHP Library(即 mongodb/mongodb Composer 包)提供,其核心类 MongoDB\Client 内部组合(compose)了一个 Manager 实例,并在此基础上封装了完整的 CRUD 和管理命令抽象。
因此,若你坚持仅使用 \MongoDB\Driver\Manager,仍可调用底层命令实现数据库枚举,但需手动构造并发送 listDatabases 命令:
<?php
$manager = new \MongoDB\Driver\Manager('mongodb://localhost:27017');
// 构造 listDatabases 命令(空文档表示默认选项)
$command = new \MongoDB\Driver\Command(['listDatabases' => 1]);
// 在 admin 数据库上下文中执行(所有管理命令均需在 admin DB 执行)
$result = $manager->executeCommand('admin', $command);
// 解析响应
$response = current($result->toArray());
$databases = $response->databases ?? [];
foreach ($databases as $db) {
echo $db->name . " ({$db->sizeOnDisk} bytes)\n";
}⚠️ 注意事项:
-
executeCommand()必须指定数据库名(此处为'admin'),因为listDatabases是管理命令,只能在admin数据库作用域下执行; - 返回结果为
\MongoDB\Driver\Cursor,需调用toArray()并提取databases字段; - 命令选项(如
nameOnly: true或filter)可按需添加,例如:['listDatabases' => 1, 'nameOnly' => true]; - 错误处理需自行捕获
\MongoDB\Driver\Exception\RuntimeException等异常。
✅ 推荐实践:迁移到 MongoDB\Client
安装官方 PHP 库:
composer require mongodb/mongodb
然后即可简洁调用:
$client = new MongoDB\Client('mongodb://localhost:27017');
$databases = $client->listDatabases(); // 返回 IteratorAggregate
foreach ($databases as $db) {
echo $db->getName() . "\n";
}该方式不仅语法更直观、类型更安全(返回 MongoDB\Model\DatabaseInfo 对象),还自动处理连接复用、重试逻辑、会话支持(如事务)及未来协议扩展,大幅降低维护成本。底层仍复用同一 Manager 实例,零性能损耗,却获得完整驱动生态支持。
总结:Manager 是基石,Client 是生产力——除非有极特殊的低层控制需求,否则应优先使用 MongoDB\Client。


















