定義
- MongoDB\Database::getCollection()
- データベース内のコレクションへのアクセスを取得します。このメソッドは - MongoDB\Database::selectCollection()のエイリアスであり、将来のリリースで置き換えられます。- function getCollection( - string $collectionName, - array $options = [] - ): MongoDB\Collection 
パラメーター
- $collectionName: string
- アクセスするコレクションの名前。
- $options: 配列
- 必要なオプションを指定する配列。 名前タイプ説明- コーデック - MongoDB\Codec\DocumentCodec - コレクション操作に使用するデフォルトのタイプ コーデックでデータをエンコードする 。 - バージョン 1.17 の新機能。 - ReadConcern - コレクション操作に使用するデフォルトの読み取り保証 (read concern) です。 デフォルトは、データベースの読み取り保証 (read concern) です。 - readPreference - コレクション操作に使用するデフォルトの読み込み設定 (read preference) 。 データベースの読み込み設定(read preference)がデフォルトで設定されます。 - typeMap - 配列 - コレクション操作に使用するデフォルトのタイプ マップ。 データベースのタイプ マップがデフォルトで設定されます。 - writeConcern - コレクション操作に使用するデフォルトの書込み保証 (write concern) です。 データベースの書込み保証 (write concern) のデフォルト。 
Return Values
MongoDB\Collectionオブジェクト。
エラーと例外
MongoDB\Exception\InvalidArgumentException は、パラメータまたはオプションの解析に関連するエラーの場合は です。
動作
選択したコレクションは、Databaseオブジェクトから読み込み設定 (read preference)やタイプ マッピングなどのオプションを継承します。$options パラメータを使用することで、オプションを上書きできます。
例
次の例では、testデータベース内の usersコレクションにアクセスします。
$db = (new MongoDB\Client)->test; $collection = $db->getCollection('users'); 
次の例では、カスタム読み込み設定 (read preference)を使用して、testデータベース内の usersコレクションにアクセスします。
$db = (new MongoDB\Client)->test; $users = $db->getCollection(     'users',     [         'readPreference' => new MongoDB\Driver\ReadPreference('primaryPreferred'),     ] );