Класс MongoDB\Driver\Manager

    (mongodb >=1.0.0)

    Введение

    Класс MongoDB\Driver\Manager является основной точкой входа в модуль. Он отвечает за поддержание соединений с MongoDB (будь то автономный сервер, набор реплик или распределённый кластер).

    При инициализации класса Manager не происходит подключение к MongoDB. Это означает, что MongoDB\Driver\Manager всегда может быть создан, даже если сервера MongoDB не работают.

    Любая запись или запрос будут выбрасывать исключение соединения, поскольку соединения создаются "лениво" (по требованию). Сервер MongoDB также может быть недоступен в течение всего времени выполнения скрипта. Поэтому важно, чтобы все действия с Manager были обёрнуты в блок try/catch.

    Обзор классов

    finalclassMongoDB\Driver\Manager {
    finalpublicaddSubscriber(MongoDB\Driver\Monitoring\Subscriber$subscriber): void
    finalpublic__construct(?string$uri = null, ?array$uriOptions = null, ?array$driverOptions = null)
    finalpubliccreateClientEncryption(array$options): MongoDB\Driver\ClientEncryption
    finalpublicexecuteBulkWrite(string$namespace, MongoDB\Driver\BulkWrite$bulk, array|MongoDB\Driver\WriteConcern|null$options = null): MongoDB\Driver\WriteResult
    finalpublicexecuteCommand(string$db, MongoDB\Driver\Command$command, array|MongoDB\Driver\ReadPreference|null$options = null): MongoDB\Driver\Cursor
    finalpublicexecuteQuery(string$namespace, MongoDB\Driver\Query$query, array|MongoDB\Driver\ReadPreference|null$options = null): MongoDB\Driver\Cursor
    finalpublicexecuteReadCommand(string$db, MongoDB\Driver\Command$command, ?array$options = null): MongoDB\Driver\Cursor
    finalpublicexecuteReadWriteCommand(string$db, MongoDB\Driver\Command$command, ?array$options = null): MongoDB\Driver\Cursor
    finalpublicexecuteWriteCommand(string$db, MongoDB\Driver\Command$command, ?array$options = null): MongoDB\Driver\Cursor
    finalpublicgetEncryptedFieldsMap(): array|object|null
    finalpublicgetReadConcern(): MongoDB\Driver\ReadConcern
    finalpublicgetReadPreference(): MongoDB\Driver\ReadPreference
    finalpublicgetServers(): array
    finalpublicgetWriteConcern(): MongoDB\Driver\WriteConcern
    finalpublicremoveSubscriber(MongoDB\Driver\Monitoring\Subscriber$subscriber): void
    finalpublicselectServer(?MongoDB\Driver\ReadPreference$readPreference = null): MongoDB\Driver\Server
    finalpublicstartSession(?array$options = null): MongoDB\Driver\Session
    }

    Примеры

    Пример #1 Простой пример использования MongoDB\Driver\Manager::__construct()

    Выводит различную информацию о MongoDB\Driver\Manager с помощью функции var_dump(). Это может быть полезно для отладки, чтобы посмотреть как драйвер видит настройку 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) { } }

    Содержание

    To Top