MongoDB\Driver\Manager::selectServer
(mongodb >=1.0.0)
MongoDB\Driver\Manager::selectServer — 읽기 기본 설정과 일치하는 서버 선택
설명
final public MongoDB\Driver\Manager::selectServer(?MongoDB\Driver\ReadPreference $readPreference
= null): MongoDB\Driver\Server
readPreference
와 일치하는 MongoDB\Driver\Server를 선택합니다. readPreference
가 null
이거나 생략된 경우 기본 서버가 기본적으로 선택됩니다. 이것은 작업을 실행하기 전에 버전 확인을 수행하기 위해 서버를 미리 선택하는 데 사용할 수 있습니다.
참고: MongoDB\Driver\Manager::getServers()와 달리 이 메서드는 데이터베이스 연결을 초기화하고 필요한 경우 서버 검색을 수행합니다. 추가 정보는 » 서버 선택 사양을 참조하세요.
매개변수
readPreference (MongoDB\Driver\ReadPreference)
- 서버 선택에 사용할 읽기 기본 설정입니다.
null
이거나 생략된 경우 기본 서버가 기본적으로 선택됩니다.
반환 값
읽기 기본 설정과 일치하는 MongoDB\Driver\Server를 반환합니다.
오류/예외
- 인수 구문 분석 오류에 대해 MongoDB\Driver\Exception\InvalidArgumentException을 던집니다.
- (인증 이외의 이유로) 서버 연결이 실패하면 MongoDB\Driver\Exception\ConnectionException을 던집니다.
- 인증이 필요하고 실패하면 MongoDB\Driver\Exception\AuthenticationException을 던집니다.
- 읽기 기본 설정과 일치하는 서버를 찾을 수 없으면 MongoDB\Driver\Exception\RuntimeException을 던집니다.
변경 로그
버전 | 설명 |
---|---|
PECL mongodb 1.11.0 | 이제 readPreference 는 선택 사항입니다. null 이거나 생략된 경우 기본 서버가 기본적으로 선택됩니다. |
기타
- MongoDB\Driver\Server
- MongoDB\Driver\Manager::getServers() - 이 관리자가 연결된 서버를 반환합니다.
- » Server Selection Specification