MongoDB\Client::selectCollection()

정의

MongoDB\Client::selectCollection()

서버에서 collection을 선택합니다.

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

매개변수

$databaseName : 문자열

선택할 collection이 포함된 데이터베이스의 이름입니다.

$collectionName : 문자열

선택할 collection의 이름입니다.

$options : 배열

원하는 옵션을 지정하는 배열입니다.

이름	유형	설명
코덱	MongoDB\Codec\DocumentCodec	collection 작업에 사용할 기본 코덱 입니다. 버전 1.17에 추가 되었습니다.
readConcern	MongoDB\Driver\ReadConcern	collection 작업에 사용할 기본 읽기 고려 (read concern)입니다. 기본값은 클라이언트의 읽기 고려 (read concern)입니다.
읽기 설정	MongoDB\Driver\ReadPreference	collection 작업에 사용할 기본 읽기 설정 (read preference)입니다. 기본값은 클라이언트의 읽기 설정 (read preference)입니다.
typeMap	배열	collection 작업에 사용할 기본 유형 맵입니다. 기본값은 클라이언트의 유형 맵입니다.
쓰기 고려	MongoDB\Driver\WriteConcern	컬렉션 작업에 사용할 기본 쓰기 고려입니다. 기본값은 클라이언트의 쓰기 고려 (write concern)입니다.

반환 값

MongoDB\Collection 객체입니다.

오류/예외

MongoDB\Exception\InvalidArgumentException 매개변수 또는 옵션의 구문 분석과 관련된 오류의 경우입니다.

행동

선택한 collection은 Client 객체에서 읽기 설정 (read preference) 및 유형 매핑과 같은 옵션을 상속합니다. 옵션은 $options 매개변수를 통해 재정의할 수 있습니다.

예제

다음 예제에서는 test 데이터베이스에서 users collection을 선택합니다.

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

다음 예제에서는 사용자 지정 읽기 설정을 사용하여 test 데이터베이스에서 users 컬렉션을 선택합니다.

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

다음도 참조하세요.

• MongoDB\Collection::__construct()

• MongoDB\Database::selectCollection()