MongoDB\Database::withOptions()

定義

MongoDB\Database::withOptions()

データベース オブジェクトのクローンを返しますが、オプションは異なります。

function withOptions(array $options = []): MongoDB\Database

パラメーター

$options : 配列

必要なオプションを指定する配列。

名前	タイプ	説明
builderEncoder	MongoDB\Codec\Encoder	クエリおよび集計オプションでネイティブPHP型をBSONデータに直列化するために使用されるエンコード。省略した場合、Databaseインスタンスはデフォルトのエンコードを使用します。 バージョン1.21の新機能。
ReadConcern	MongoDB\Driver\ReadConcern	データベース操作に使用するデフォルトの読み取り保証 (read concern) です。 デフォルトは、元のデータベースの読み取り保証 (read concern) です。
readPreference	MongoDB\Driver\ReadPreference	データベース操作に使用するデフォルトの読み込み設定 (read preference) 。 デフォルトでは、元のデータベースの読み込み設定（read preference）に設定されます。
typeMap	配列	カーソルに適用する 型マップ。これにより BSON ドキュメントが PHP 値に変換される方法が決定されます。デフォルトでは元のデータベースのタイプ マップが使用されます。
writeConcern	MongoDB\Driver\WriteConcern	データベース操作に使用するデフォルトの書込み保証 (write concern) です。 デフォルトは、元のデータベースの書込み保証 (write concern) です。

Return Values

MongoDB\Databaseオブジェクト。

エラーと例外

MongoDB\Exception\InvalidArgumentException は、パラメータまたはオプションの解析に関連するエラーの場合は です。

例

次の例では、既存の データベース オブジェクトを新しい読み込み設定（read preference）で複製します。

<?php
$db = (new MongoDB\Client)->test;
$newDb = $db->withOptions([
    'readPreference' => new MongoDB\Driver\ReadPreference('primaryPreferred'),
]);

その他の参照

• MongoDB\Database::__construct()