Docs Menu

Retrieve Data

이 가이드 에서는 MongoDB PHP 라이브러리를 사용하여 읽기 작업 을 통해 MongoDB 컬렉션 에서 데이터를 조회 하는 방법을 학습 수 있습니다. 컬렉션 에서 MongoDB\Collection::find() 또는 MongoDB\Collection::findOne() 메서드를 호출하여 기준 설정하다 와 일치하는 문서를 조회 할 수 있습니다.

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트sample_training 데이터베이스 에 있는 companies 컬렉션 을 사용합니다. PHP 애플리케이션 에서 이 컬렉션 에 액세스 하려면 Atlas cluster 에 연결하는 MongoDB\Client 를 인스턴스화하고 $collection 변수에 다음 값을 할당합니다.

$collection = $client->sample_training->companies;

무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.

MongoDB PHP 라이브러리에는 컬렉션 에서 문서를 검색하는 두 가지 메서드 MongoDB\Collection::findOne()MongoDB\Collection::find() 가 포함되어 있습니다. 이러한 메서드는 쿼리 필터하다 를 사용하여 하나 이상의 일치하는 문서를 반환합니다. 쿼리 필터하다 는 운전자 가 쿼리 에서 문서를 조회 하는 데 사용하는 검색 기준을 지정합니다.

쿼리 필터에 학습 보려면 쿼리 지정 가이드 를 참조하세요.

컬렉션 에서 단일 문서 를 찾으려면 MongoDB\Collection::findOne() 메서드를 호출하고 찾으려는 문서 의 기준을 지정하는 쿼리 필터하다 를 전달합니다.

findOne() 메서드는 array, object 또는 null 값을 반환합니다. 쿼리 필터하다 가 문서 와 일치하면 메서드는 해당 문서 가 포함된 array|object 인스턴스 를 반환합니다. 반환 유형은 typeMap 옵션의 값에 따라 달라집니다. 쿼리 필터하다 가 어떤 문서와도 일치하지 않으면 메서드는 null 를 반환합니다.

typeMap 와 같은 findOne() 옵션에 학습 보려면 이 가이드 의 찾기 동작 수정 섹션을 참조하세요.

쿼리 필터하다 가 둘 이상의 문서 와 일치하는 경우 findOne() 메서드는 조회된 결과에서 첫 번째 로 일치하는 문서 를 반환합니다.

다음 예시 에서는 findOne() 메서드를 사용하여 name 필드 의 값이 'LinkedIn' 인 첫 번째 문서 를 찾습니다.

$document = $collection->findOne(['name' => 'LinkedIn']);
echo json_encode($document), PHP_EOL;
{"_id":{"$oid":"..."},"name":"LinkedIn","permalink":"linkedin","crunchbase_url":
"http:\/\/www.crunchbase.com\/company\/linkedin","homepage_url":"http:\/\/linkedin.com",
... }

정렬 순서

정렬 기준이 지정되지 않은 경우 findOne() 메서드는 디스크에 기본 순서에 따라 첫 번째 문서를 반환합니다.

컬렉션에서 여러 문서를 찾으려면 검색하려는 문서의 기준을 지정하는 MongoDB\Collection::find() 메서드에 쿼리 필터를 전달합니다.

다음 예시 에서는 find() 메서드를 사용하여 founded_year 필드 에 1970 값이 있는 모든 문서를 찾습니다.

$results = $collection->find(['founded_year' => 1970]);

find() 메서드는 MongoDB\Driver\Cursor 인스턴스 를 반환하며, 이를 반복하여 일치하는 문서를 볼 수 있습니다. 커서 는 애플리케이션 이 주어진 시간에 데이터베이스 결과의 하위 집합만 메모리에 유지하면서 데이터베이스 결과를 반복할 수 있는 메커니즘입니다. 커서는 find() 메서드가 많은 양의 문서를 반환할 때 유용합니다.

다음 예제와 같이 foreach 루프를 사용하여 커서에 있는 문서를 반복할 수 있습니다.

foreach ($results as $doc) {
echo json_encode($doc), PHP_EOL;
}
{"_id":{"$oid":"..."},"name":"Mitsubishi Motors","permalink":"mitsubishi-motors",
"crunchbase_url":"http:\/\/www.crunchbase.com\/company\/mitsubishi-motors",
... }
{"_id":{"$oid":"..."},"name":"Western Digital","permalink":"western-digital",
"crunchbase_url":"http:\/\/www.crunchbase.com\/company\/western-digital",
... }
{"_id":{"$oid":"..."},"name":"Celarayn","permalink":"celarayn","crunchbase_url":
"http:\/\/www.crunchbase.com\/company\/celarayn",
... }

참고

모든 문서 찾기

컬렉션의 모든 문서를 찾으려면 find() 메서드에 빈 필터를 전달합니다.

$cursor = $collection->find([]);

옵션 값을 매개 변수로 지정하는 배열 을 전달하여 MongoDB\Collection::find()MongoDB\Collection::findOne() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 배열 에서 설정하다 수 있는 몇 가지 옵션을 설명합니다.

옵션
설명

batchSize

The number of documents to return per batch. The default value is 101.
Type: integer

collation

The collation to use for the operation. The default value is the collation specified for the collection.
Type: array|object

comment

The comment to attach to the operation.
Type: any BSON type

cursorType

The type of cursor to use for the operation. The default value is MongoDB\Operation\Find::NON_TAILABLE.
Type: MongoDB\Operation\Find

limit

The maximum number of documents the operation can return.
Type: integer

skip

The number of documents to skip before returning results.
Type: integer

sort

The order in which the operation returns matching documents.
Type: array|object

typeMap

The type map to apply to cursors, which determines how BSON documents are converted to PHP values. The default value is the collection's type map.
Type: array

다음 예시 에서는 find() 메서드를 사용하여 number_of_employees 필드 에 1000 값이 있는 모든 문서를 찾습니다. 이 예시 에서는 limit 옵션을 사용하여 최대 5 결과를 반환합니다.

$results = $collection->find(
['number_of_employees' => 1000],
['limit' => 5]
);
foreach ($results as $doc) {
echo json_encode($doc), PHP_EOL;
}

전체 옵션 목록은 findOne()find() 매개변수에 대한 API 설명서를 참조하세요.

쿼리 필터에 학습 보려면 쿼리 지정 가이드 를 참조하세요.

MongoDB PHP 라이브러리를 사용하여 문서를 검색하는 코드 예제를 보려면 MongoDB MongoDB 데이터 읽기를 참조하세요.

이 가이드에서 설명하는 메서드에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.