MongoDB\Database::__construct()

Definition

MongoDB\Database::__construct()

Constructs a new Database instance.

function __construct(
    MongoDB\Driver\Manager $manager,
    string $databaseName,
    array $options = []
)

Parameters

$manager : MongoDB\Driver\Manager

The Manager instance from the extension. The manager maintains connections between the driver and MongoDB.

$databaseName : string

The name of the database.

$options : array

An array specifying the desired options.

Name	Type	Description
builderEncoder	MongoDB\Codec\Encoder	Encoder to use for query and aggregation builders. If not set, this option defaults to a new instance of the MongoDB\Builder\BuilderEncoder class. New in version 1.21.
readConcern	MongoDB\Driver\ReadConcern	The default read concern to use for database operations. Defaults to the manager's read concern.
readPreference	MongoDB\Driver\ReadPreference	The default read preference to use for database operations. Defaults to the manager's read preference.
typeMap	array	Default type map to apply to cursors, which determines how BSON documents are converted to PHP values. The library uses the following type map by default: [ 'array' => 'MongoDB\Model\BSONArray', 'document' => 'MongoDB\Model\BSONDocument', 'root' => 'MongoDB\Model\BSONDocument', ]
writeConcern	MongoDB\Driver\WriteConcern	The default write concern to use for database operations. Defaults to the manager's write concern.

Errors/Exceptions

MongoDB\Exception\InvalidArgumentException for errors related to the parsing of parameters or options.

Behavior

If you construct a Database explicitly, the Database inherits any options from the MongoDB\Driver\Manager object. If you select the Database from a Client object, the Database inherits its options from that object.

See Also

• MongoDB\Database::withOptions()

• MongoDB\Client::getDatabase()

• MongoDB\Client::__get()