PHP8 MongoDB\Driver\Manager 类
(mongoDB >=1.0.0)
简介
MongoDB\Driver\Manager 是主要入口点 到扩展。它负责维护与 MongoDB 的连接 (无论是独立服务器、副本集还是分片集群)。
实例化管理器时不会与 MongoDB 建立连接。 这意味着 MongoDB\Driver\Manager 始终可以 构造,即使一个或多个 MongoDB 服务器已关闭。
任何写入或查询都可能引发连接异常,因为连接是延迟创建的。 MongoDB 服务器也可能在脚本的生命周期内变得不可用。 因此,必须将 Manager 上的所有操作都包装在 try/catch 语句中。
类摘要
final class MongoDB\Driver\Manager {
/* 方法 */
final public addSubscriber(MongoDB\Driver\Monitoring\Subscriber $subscriber): void
final public __construct(?string $uri = null, ?array $uriOptions = null, ?array $driverOptions = null)
final public createClientEncryption(array $options): MongoDB\Driver\ClientEncryption
final public executeBulkWrite(string $namespace, MongoDB\Driver\BulkWrite $bulk, array|MongoDB\Driver\WriteConcern|null $options = null): MongoDB\Driver\WriteResult
final public executeCommand(string $db, MongoDB\Driver\Command $command, array|MongoDB\Driver\ReadPreference|null $options = null): MongoDB\Driver\Cursor
final public executeQuery(string $namespace, MongoDB\Driver\Query $query, array|MongoDB\Driver\ReadPreference|null $options = null): MongoDB\Driver\Cursor
final public executeReadCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
final public executeReadWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
final public executeWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
final public getEncryptedFieldsMap(): array|object|null
final public getReadConcern(): MongoDB\Driver\ReadConcern
final public getReadPreference(): MongoDB\Driver\ReadPreference
final public getServers(): array
final public getWriteConcern(): MongoDB\Driver\WriteConcern
final public removeSubscriber(MongoDB\Driver\Monitoring\Subscriber $subscriber): void
final public selectServer(?MongoDB\Driver\ReadPreference $readPreference = null): MongoDB\Driver\Server
final public startSession(?array $options = null): MongoDB\Driver\Session
}
示例
示例 #1 MongoDB\Driver\Manager::__construct() basic example
var_dump()ing MongoDB\Driver\Manager将打印出各种 有关经理的详细信息,否则通常不会公开。 这对于调试驱动程序如何查看 MongoDB 设置以及 使用哪些选项。
<?php
$manager = new MongoDB\Driver\Manager('mongodb://localhost:27017');
var_dump($manager);
?>
以上示例的输出类似于:
object(MongoDB\Driver\Manager)#1 (2) { ["uri"]=> string(26) "mongodb://127.0.0.1:27017/" ["cluster"]=> array(0) { } }