Retrieve Data

샘플 데이터

The examples in this guide use the companies collection in the sample_training database from the Atlas sample datasets. To access this collection from your PHP application, instantiate a MongoDB\Client that connects to an Atlas cluster and assign the following value to your $collection variable:

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

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

하나의 문서 찾기

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

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

쿼리 필터하다 가 둘 이상의 문서 와 일치하는 경우 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",
... }

여러 문서 찾기

컬렉션에서 여러 문서를 찾으려면 검색하려는 문서의 기준을 지정하는 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",
... }

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

검색 동작 수정

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

다음 예시 에서는 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 설명서를 참조하세요.

API 문서

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

• MongoDB\Collection::findOne()

• MongoDB\Collection::find()