릴리스 노트

1.21의 새로운 기능

PHP 라이브러리 v1.21 출시하다 에는 다음과 같은 기능, 개선 사항 및 수정 사항이 포함되어 있습니다.

• 보다 유형이 안전한 방식으로 집계 파이프라인을 빌드 할 수 있는 API 집계 빌더를 소개합니다. 자세한 내용을 학습 예시를 보려면 애그리게이션 가이드 의 애그리게이션 빌더 섹션을 참조하세요.

• 다음 메서드를 추가합니다.

  • MongoDB\Client::getDatabase(): 별칭 MongoDB\Client::selectDatabase()

  • MongoDB\Database::getCollection(): 별칭 MongoDB\Database::selectCollection()

  • MongoDB\Database::getCollection(): 별칭 MongoDB\Database::selectCollection()

  Client::selectCollection(), Client::selectDatabase() 및 Database::selectCollection() 메서드는 향후 운전자 출시하다 에서 더 이상 사용되지 않으며 이러한 새 메서드로 대체될 예정이므로 애플리케이션 에서 사용법을 변경하는 것이 좋습니다.

• SearchStage, VectorSearchStage 및 SearchMetaStage 빌더 클래스에 대한 명명된 인수를 추가합니다. 이 변경 사항을 통해 Atlas Search 및 Atlas Vector Search 쿼리를 보다 유형 안전하고 조직적인 방식으로 쓰기 (write) 수 있습니다. 자세한 학습 은 Atlas Search 쿼리 실행 및 Atlas Vector Search 쿼리 실행 가이드를 참조하세요.

• 더 이상 사용되지 않는 MMAPv1 스토리지 엔진 에 사용되는 flags 옵션을 더 이상 사용하지 않습니다. 이 옵션은 PHP 라이브러리 v2.0에서 제거될 예정입니다.

• MongoDB\Collection::updateOne() 및 MongoDB\Collection::replaceOne() 메서드에 정렬 옵션을 추가합니다. 이 변경 사항을 통해 대량 작업에서 업데이트 및 바꾸기 작업을 수행할 때 정렬 순서를 옵션으로 설정하다 수도 있습니다.

• 다음 메서드에 builderEncoder 옵션을 추가합니다.

  • Database constructor

  • MongoDB\Database::withOptions()

  • Collection constructor

  • MongoDB\Collection::withOptions()

이 버전의 변경 사항에 대한 자세한 내용은 Github 의 v1.21 출시하다 노트 를 참조하세요.

1.20의 새로운 기능

• MongoDB Server v8.0 에 대한 지원 을 추가합니다.

• Queryable Encryption (QE) 범위 쿼리에 대한 지원 을 추가합니다. 이 기능 을 사용하려면 앱 이 MongoDB Server 8.0 이상에 연결되어야 합니다. QE 범위 쿼리에 대한 자세한 내용은 MongoDB Server 매뉴얼의 Queryable Encryption 을 참조하세요.

• 샤딩된 클러스터 작업이 실패하면 라이브러리는 다른 mongos 서버를 사용할 수 있는 경우 작업 재시도를 위해 동일한 mongos 서버 를 선택하지 않습니다.

• 이제 KMIP 데이터 키를 만들 때 delegated 옵션을 지정할 수 있습니다. 이 옵션을 true 로 설정하다 하면 KMIP 제공자 가 데이터 키의 암호화 및 암호 해독을 로컬에서 수행하여 암호화 키 가 KMIP 서버 를 벗어나지 않도록 합니다.

• type 및 MongoDB\Collection::createIndex() MongoDB\Collection::createSearchIndexes() 메서드에 대한 검색 인덱스 사양에 옵션을 추가합니다. 이 변경 사항을 통해 프로그래밍 방식으로 Atlas Vector Search 인덱스를 만들 수 있습니다. 자세한 내용을 학습 예시를 보려면 Atlas Search 인덱스 가이드 참조하세요.

이 버전의 변경 사항에 대한 자세한 내용은 Github 의 v1.20 출시하다 노트를 참조하세요.

1.19의 새로운 기능

이번 PHP 라이브러리 출시하다 에는 중요한 변경 사항이 없으며 PHP 확장과 버전 패리티를 유지하기 위해 추가되었습니다.

1.18의 새로운 기능

• 새로운 GridFS API 추가하여 PHP의 기존 파일 시스템 기능을 사용하여 파일 작업을 더 편리하게 수행할 수 있도록 합니다. MongoDB\GridFS\Bucket::registerGlobalStreamWrapperAlias() 메서드를 사용하여 GridFS 버킷의 전역 별칭을 등록할 수 있습니다. 이렇게 하면 파일 URI(예: "gridfs://mybucket/hello.txt"). 이 API 의 데모는 gridfs_stream_wrapper.php 예시 스크립트 에서 확인할 수 있습니다.

• MongoDB\Client 클래스에 MongoDB\Client::addSubscriber() 및 MongoDB\Client::removeSubscriber() 메서드를 추가하여 기본 MongoDB\Driver\Manager 객체 로 범위가 지정된 모니터링 클래스를 더 쉽게 등록할 수 있습니다.

이 출시하다 에 대해 자세히 학습 Github 의 v1.18 릴리스 노트 참조하세요.

1.17의 새로운 기능

• BSON 을 PHP 객체와 변환하기 위한 새로운 '코덱' API 를 도입합니다. 이 기능 에 대한 자세한 내용은 코덱 튜토리얼에서 확인할 수 있습니다.

• 라이브러리에MongoDB\add_logger()및MongoDB\remove_logger()함수를 추가합니다. 이러한 함수를 통해 애플리케이션은 PSR-3 로거를 등록하여 운전자 에서 방출하는 로그 메시지를 받을 수 있습니다. 이전에는 확장 프로그램의 mongodb.debug INI 설정을 통해서만 로그를 사용할 수 있었습니다.

• Atlas Search 인덱스를 생성하고 관리 새로운 MongoDB\Collection 메서드를 도입합니다. Atlas Search 인덱스는 라이브러리의 모든 버전에서 지원되는 $search 집계 파이프라인 단계를 사용하여 쿼리할 수 있습니다. Atlas Search 인덱스와 $search 집계 단계의 세부 사항에 학습 보려면 Atlas Search 인덱스 문서 및 $ 검색 를 참조하세요.

• mongodb 확장 요구 사항을 1.17.0 로 업그레이드합니다. PHP 7.2 및 7.3 에 대한 지원이 제거되었으며 라이브러리에는 이제 PHP 7.4 이상이 필요합니다.

이 출시하다 에 대해 자세히 학습 Github 의 v1.17 릴리스 노트 참조하세요.