如何在仅使用 MongoDB Driver Manager 时列出数据库-php教程-PHP中文网

如何在仅使用 MongoDB Driver Manager 时列出数据库

当仅使用底层 MongoDB\Driver\Manager（而非 MongoDB\Client）时，可通过手动执行 listDatabases 命令获取数据库列表，本文详解实现方法、代码示例及迁移建议。

当仅使用底层 `mongodb\driver\manager`（而非 `mongodb\client`）时，可通过手动执行 `listdatabases` 命令获取数据库列表，本文详解实现方法、代码示例及迁移建议。

MongoDB\Driver\Manager 是 PHP MongoDB 驱动扩展（ext-mongodb）提供的底层连接管理器，它直接封装 C 驱动，不包含高级操作方法（如 listDatabases()、selectDatabase() 等）。这些便捷接口由上层的 MongoDB PHP Library（即 mongodb/mongodb Composer 包）提供，其核心类 MongoDB\Client 内部组合（compose）了 MongoDB\Driver\Manager，并封装了完整的命令抽象与结果处理逻辑。

因此，若坚持使用纯驱动（未引入 mongodb/mongodb 库），需手动构造并发送 listDatabases 数据库命令：

<?php $manager = new \MongoDB\Driver\Manager('mongodb://localhost:27017');

// 构造 listDatabases 命令（空文档表示默认选项）
$command = new \MongoDB\Driver\Command(['listDatabases' => 1]);

try {
    $result = $manager->executeCommand('admin', $command);
    $response = current($result->toArray()); // 获取唯一响应文档

    echo "Found " . $response->databases->count() . " databases:\n";
    foreach ($response->databases as $db) {
        echo "- {$db->name} ({$db->sizeOnDisk} bytes, {$db->empty ? 'empty' : 'not empty'})\n";
    }
} catch (\MongoDB\Driver\Exception $e) {
    throw new RuntimeException('Failed to list databases: ' . $e->getMessage(), $e->getCode(), $e);
}

⚠️ 注意事项：

mongodb-query
用于调试和故障排查，查询MongoDB数据库。用户需要时可以： (1) 列出所有数据库； (2) 列出数据库中的集合； (3) 执行MongoDB查询或命令。

下载

listDatabases 命令必须在 admin 数据库上下文中执行（这是 MongoDB 的强制要求）；

返回结果为 MongoDB\Driver\Cursor，需调用 toArray() 并取首项（因该命令始终返回单文档响应）；

若连接无足够权限（如缺少 listDatabases action），将抛出 \MongoDB\Driver\Exception\RuntimeException；

手动命令缺乏自动重试、超时继承、类型转换（如 ObjectId、DateTime）等高级库特性。

✅ 强烈推荐的实践路径：
升级至官方 MongoDB PHP Library（composer require mongodb/mongodb），它完全兼容现有 Manager 实例，并提供面向开发者的高阶 API：

composer require mongodb/mongodb

<?php use MongoDB\Client;

// 可复用已有 Manager 实例（避免重复连接）
$manager = new \MongoDB\Driver\Manager('mongodb://localhost:27017');
$client = new Client(null, [], ['manager' => $manager]); // 注入自定义 Manager

$databases = $client->listDatabases(); // 直接调用，返回 Iterator
foreach ($databases as $db) {
    echo "Database: {$db->getName()}\n";
}

此举既保留对连接池的精细控制，又获得类型安全、可读性强、符合 MongoDB 官方驱动规范的开发体验。底层仍由 ext-mongodb 驱动执行，但业务逻辑无需再与原始命令细节耦合。