MongoDB\Database::selectGridFSBucket()

정의

MongoDB\Database::selectGridFSBucket()

데이터베이스 내에서 GridFS 버킷을 선택합니다.

function selectGridFSBucket(array $options = []): MongoDB\GridFS\Bucket

매개변수

$options : 배열

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

이름	유형	설명
bucketName	문자열	파일 및 청크 컬렉션의 접두사로 사용될 버킷 이름입니다. 기본값은 "fs" 입니다.
청크 크기 바이트	integer	청크 크기(바이트)입니다. 기본값은 261120 (예: 255KiB).
코덱	MongoDB\Codec\DocumentCodec	파일 문서를 반환하는 버킷 메서드에 사용할 기본 코덱 (예: MongoDB\GridFS\Bucket::find())입니다. 버전 1.17에 추가 되었습니다.
disableMD5	부울	파일 저장 시 자동 MD5 생성을 비활성화할지 여부입니다. 기본값은 false 입니다. 2.0 에서는 true 만 지원됩니다. 버전 1.4에 새로 추가되었습니다.
readConcern	MongoDB\Driver\ReadConcern	버킷 작업에 사용할 기본 읽기 고려 (read concern)입니다. 기본값은 데이터베이스의 읽기 고려 (read concern)입니다.
읽기 설정	MongoDB\Driver\ReadPreference	버킷 작업에 사용할 기본 읽기 설정입니다. 기본값은 데이터베이스의 읽기 고려 (read concern)입니다.
typeMap	배열	버킷 작업에 사용할 기본 유형 맵입니다. 기본값은 데이터베이스의 유형 맵입니다.
쓰기 고려	MongoDB\Driver\WriteConcern	버킷 작업에 사용할 기본 쓰기 고려 (write concern)입니다. 기본값은 데이터베이스의 쓰기 고려 (write concern)입니다.

반환 값

MongoDB\GridFS\Bucket 객체입니다.

오류/예외

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

행동

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

예제

다음 예에서는 test 데이터베이스에서 기본 fs.files 버킷을 선택합니다.

<?php
$db = (new MongoDB\Client)->test;
$bucket = $db->selectGridFSBucket();

다음 예에서는 사용자 지정 읽기 설정 (read preference)을 사용하여 test 데이터베이스에서 사용자 지정 images.files 버킷을 선택합니다.

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

다음도 참조하세요.

• MongoDB\GridFS\Bucket::__construct()