/ /

/ /

MongoDB\Database::selectCollection()

定義

MongoDB\Database::selectCollection()

データベース内のコレクションを選択します。このメソッドは MongoDB\Database::getCollection() によってエイリアスされ、将来のリリースで置き換えられる予定です。

function selectCollection(
    string $collectionName,
    array $options = []
): MongoDB\Collection

パラメーター

$collectionName : string

選択するコレクションの名前。

$options : 配列

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

名前	タイプ	説明
コーデック	MongoDB\Codec\DocumentCodec	コレクション操作に使用するデフォルトのタイプコーデックでデータをエンコードする。バージョン 1.17 の新機能。
ReadConcern	MongoDB\Driver\ReadConcern	コレクション操作に使用するデフォルトの読み取り保証 (read concern) です。デフォルトは、データベースの読み取り保証 (read concern) です。
readPreference	MongoDB\Driver\ReadPreference	コレクション操作に使用するデフォルトの読み込み設定 (read preference) 。データベースの読み込み設定（read preference）がデフォルトで設定されます。
typeMap	配列	コレクション操作に使用するデフォルトのタイプマップ。データベースのタイプマップがデフォルトで設定されます。
writeConcern	MongoDB\Driver\WriteConcern	コレクション操作に使用するデフォルトの書込み保証 (write concern) です。データベースの書込み保証 (write concern) のデフォルト。

Return Values

MongoDB\Collectionオブジェクト。

エラーと例外

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

動作

選択したコレクションは、Databaseオブジェクトから読み込み設定 (read preference)やタイプマッピングなどのオプションを継承します。$options パラメータを使用することで、オプションを上書きできます。

例

次の例えでは、 testデータベース内のusersコレクションを選択します。

<?php
$db = (new MongoDB\Client)->test;
$collection = $db->selectCollection('users');

次の例では、カスタム読み取り設定を使用してtestデータベース内のusersコレクションを選択します。

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

その他の参照

戻る

renameCollection()

[selectGridFSbucket()]