Клас MongoDB\Driver\Manager
(mongodb >=1.0.0)
Вступ
КлассMongoDB\Driver\Manager є основною точкою входу модуль. Він відповідає за підтримку з'єднань з MongoDB (будь то автономний сервер, набір реплік або розподілений кластер).
Під час ініціалізації класу Manager не підключено до 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()
Виводить різну інформацію про MongoDB\Driver\Manager за допомогою функції var_dump(). Це може бути корисним для налагодження, щоб подивитися як драйвер бачить налаштування MongoDB і які опції використовуються.
Loading...
Висновок наведеного прикладу буде схожим на:
object(MongoDB\Driver\Manager)#1 (2) {
["uri"]=>
string(26) "mongodb://127.0.0.1:27017/"
["cluster"]=>
array(0) {
}
}
Зміст
- MongoDB\Driver\Manager::addSubscriber— Реєструє передплатника на подію моніторингу в даному об'єкті Manager
- MongoDB\Driver\Manager::__construct - Створює новий Manager MongoDB
- MongoDB\Driver\Manager::createClientEncryption— Створення нового об'єкта ClientEncryption
- MongoDB\Driver\Manager::executeBulkWrite— Виконує одну або кілька операцій запису
- MongoDB\Driver\Manager::executeCommand - Виконує команду бази даних
- MongoDB\Driver\Manager::executeQuery— Виконує запит до бази даних
- MongoDB\Driver\Manager::executeReadCommand - Виконує команду бази даних, яка читає
- MongoDB\Driver\Manager::executeReadWriteCommand— Виконує команду бази даних, яка читає та пише
- MongoDB\Driver\Manager::executeWriteCommand - Виконує команду бази даних, яка пише
- MongoDB\Driver\Manager::getEncryptedFieldsMap— Повертає опцію автоматичного шифрування encryptedFieldsMap для Manager
- MongoDB\Driver\Manager::getReadConcern— Повертає ReadConcern для Manager
- MongoDB\Driver\Manager::getReadPreference— Повертає ReadPreference для Manager
- MongoDB\Driver\Manager::getServers— Повертає сервери, до яких підключено менеджера
- MongoDB\Driver\Manager::getWriteConcern— Повертає WriteConcern для Manager
- MongoDB\Driver\Manager::removeSubscriber— Скасує реєстрацію передплатника на подію моніторингу на даному об'єкті Manager
- MongoDB\Driver\Manager::selectServer— Вибрати сервер, який відповідає перевагам читання
- MongoDB\Driver\Manager::startSession— Запуск нового клієнтського сеансу для використання з цим клієнтом