AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

릴리스 노트

다음 버전의 MongoDB PHP 라이브러리에 도입된 새로운 기능, 개선 사항 및 수정 사항에 대해 알아보세요.

2.5의 새로운 기능

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

  • PHP 확장 요구 사항을 버전 2.5 이상으로 업그레이드합니다.

  • 클라이언트 배압(backpressure)에 대한 지원을 추가합니다. 서버가 양수 baseBackoffMS 값과 함께 재시도 가능한 과부하 오류를 반환하면 드라이버는 드라이버 기본값 대신 해당 값을 재시도 백오프의 기준으로 사용합니다.

  • MongoDB\Client 생성자와 MongoDB\Client::createClientEncryption() 메서드에 전달하는 옵션에 대한 배열 형태의 유형 정의를 추가합니다. PHPStan 및 Psalm과 같은 정적 분석 도구는 이러한 유형을 사용하여 클라이언트, 드라이버 및 자동 암호화 옵션의 유효성을 검사할 수 있습니다.

  • MongoDB\GridFS\Bucket::uploadFromStream() 메서드가 대상 스트림을 닫지 않아 파일이 데이터베이스에 기록되지 않는 문제를 수정했습니다.

중요

PHP 확장 v2.5.3 CVE-2026-96745에 대한 수정 사항이 포함되어 있습니다.

MongoDB 보안 업데이트에 대한 최신 정보는 MongoDB 보안 게시판을 참조하세요.

이 버전의 전체 변경 사항 목록은 GitHub에서 v2.5 릴리스 노트를 참조하세요.

2.4.2의 새로운 기능

PHP 라이브러리 v2.4.2 출시에는 다음과 같은 변경 사항이 포함되어 있습니다.

중요

PHP 라이브러리 v2.4.2 CVE-2026-88023.에 대한 수정 사항이 포함되어 있습니다.

MongoDB 보안 업데이트에 대한 최신 정보는 MongoDB 보안 게시판을 참조하세요.

이 버전의 변경 사항에 대한 전체 목록은 Github의 v2.4.2 릴리스 노트를 참조하세요.

2.4.1의 새로운 기능

PHP 라이브러리 v2.4.1 출시에는 다음과 같은 변경 사항이 포함되어 있습니다.

중요

PHP 라이브러리 v2.4.1 CVE-2026-81525.에 대한 수정 사항이 포함되어 있습니다.

MongoDB 보안 업데이트에 대한 최신 정보는 MongoDB 보안 게시판을 참조하세요.

이 버전의 변경 사항에 대한 전체 목록은 Github의 v2.4.1 릴리스 노트를 참조하세요.

2.4의 새로운 기능

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

  • 빌더 API의 $rerank 집계 파이프라인 단계에 대한 지원을 추가합니다. Stage::rerank() 팩토리 메서드를 사용하여 Voyage AI의 재순위 모델을 사용하여 입력 문서의 순서를 바꾸고 관련성에 따라 정렬된 동일한 문서를 반환할 수 있습니다.

  • MongoDB 벡터 검색 인덱스 정의에서 storedSource 옵션에 대한 지원을 추가합니다. 이 옵션을 사용하여 지정된 필드의 복사본을 인덱스에 저장하여 쿼리 시 더 빠른 검색을 수행할 수 있습니다. 자세한 내용은 MongoDB Search 인덱스 가이드의 storedSource 옵션 사용을 참조하세요.

  • MongoDB\드라이버\ClientEncryption::encrypt() 메서드에서 stringOpts 옵션에 대한 지원이 추가되었습니다. 이 옵션을 String 알고리즘과 함께 사용하여 대소문자 및 분음 기호 구분과 길이 제약 조건을 지정할 수 있습니다. 접두사, 접미사 및 부분 문자열 쿼리에는 MongoDB Server v9.0 이후 버전이어야 합니다. 자세히 알아보려면 명시적 암호화를 참조하세요.

중요

다음 기능을 사용하려면 MongoDB Server v8.3 이상이 필요합니다.

  • 새로운 $convert 기능에 대한 빌더 지원을 추가합니다. $convert을(를) 사용하여 다음을 수행할 수 있습니다.

    • 숫자 기수 변환을 수행합니다.

    • 모든 유형을 string 형식으로 변환합니다.

    • JSON string을 배열 또는 객체로 변환합니다.

  • BinData 값의 하위 유형 정수를 반환하는 $subtype에 대한 지원을 추가합니다.

  • 무작위 ObjectId 값을 생성하는 $createObjectId에 대한 지원을 추가합니다.

  • 집계 string 표현식에 정규 표현식에 대한 지원을 추가합니다. 이제 $replaceOne과 $replaceAll의 find 인수에 정규 표현식을 사용할 수 있으며 $split의 구분 기호로도 사용할 수 있습니다.

이 버전의 전체 변경 사항 목록은 GitHub에서 v2.4 릴리스 노트를 참조하세요.

2.3의 새로운 기능

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

  • 빌더 API 에서 원자 업데이트 연산자에 대한 지원 추가합니다. MongoDB\Builder\Update 클래스의 팩토리 메서드를 사용하여 코드 완성 및 유형 검사를 통해 업데이트 문서를 구성할 수 있습니다. 자세히 학습 문서 업데이트 가이드 의 업데이트 빌더 섹션을 참조하세요.

  • PHP 확장 요구 사항을 버전 2.3 이상으로 업그레이드합니다.

  • MongoDB Server v4.2에 대한 지원 중단합니다. 향후 버전의 PHP 라이브러리에는 MongoDB Server v4.4 이상이 필요합니다.

  • enableOverloadRetargeting 및 maxAdaptiveRetries URI 옵션을 추가합니다. 이 옵션은 드라이버가 과부하된 서버를 만나는 경우 재시도 동작을 제어하며 MongoDB 9.0 이상에서만 지원됩니다. 자세한 내용은 서버 선택 및 검색 옵션을 참조하세요.

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

2.2의 새로운 기능

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

  • 임의의 ObjectID를 생성하기 위해 $createObjectIds 집계 파이프라인 연산자 에 대한 지원 추가합니다.

  • $concatArrays 및 $setUnion 집계 축적자에 대한 지원 추가합니다.

  • $scoreFusion 파이프라인 단계에 대한 지원 추가합니다.

  • 파이프라인 업데이트를 사용할 때 MongoDB\Collection::findOneAndUpdate() 메서드에서 Pipeline 인스턴스 전달할 수 있습니다.

  • MongoDB\Model\CollectionInfo 클래스에 새 MongoDB\Model\CollectionInfo::isView() 메서드를 추가합니다.

  • MongoDB\Database::getCollection()와의 일관성 위해 MongoDB\Database::getGridFSBucket() 메서드를 추가합니다.

2.1의 새로운 기능

중요

호환성이 손상되는 변경

PHP 라이브러리 v2.1 출시하다 에는 다음과 같은 호환성이 손상되는 변경이 도입되었습니다.

  • MongoDB Server 4.0에 대한 지원 중단합니다. 지원되는 최소 MongoDB Server 버전은 4.2입니다.

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

  • PHP 8.5과의 호환성을 추가합니다.

  • 클라이언트 대량 쓰기 (write) API 추가하여 동일한 호출로 여러 데이터베이스 및 컬렉션에 대한 쓰기 (write) 작업을 수행할 수 있습니다. 이 기능에 대해 자세히 학습하려면 대량 쓰기 작업 가이드의 클라이언트 대량 쓰기 섹션을 참조하세요.

2.0의 새로운 기능

중요

호환성이 손상되는 변경

PHP 라이브러리 v2.0 출시하다 에는 다음과 같은 호환성이 손상되는 변경이 도입되었습니다.

  • 다음 메서드는 원시 명령 응답 대신 void 를 반환합니다.

    • MongoDB\Client: dropDatabase()

    • MongoDB\Collection: drop(), dropIndex(), dropIndexes(), dropSearchIndex(), rename()

    • MongoDB\Database: createCollection(), drop(), dropCollection(), renameCollection()

이 출시하다 의 호환성이 손상되는 변경에 대해 자세히 학습하려면 라이브러리 버전 업그레이드 가이드의 버전 2.0 호환성이 손상되는 변경 섹션을 참조하세요.

PHP 라이브러리 v2.0 출시하다 에는 다음과 같은 API 변경 사항 및 제거 사항이 포함되어 있습니다.

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

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

  • MongoDB\Database::aggregate() 및 MongoDB\Collection::aggregate() 메서드를 수정하여 Pipeline 인스턴스 $pipeline 매개 변수로 허용할 수 있도록 합니다. 이 구성을 사용하는 예제를 보려면 애그리게이션 가이드의 애그리게이션 빌더 섹션을 참조하세요.

  • 더 나은 확장성과 호환성을 위해 Cursor 유형 힌트를 CursorInterface 로 대체합니다.

  • GridFS 유형에서 더 이상 사용되지 않는 필드를 제거합니다.

    • 파일 이 GridFS 에 업로드될 때 라이브러리는 md5 필드 계산하지 않습니다. 애플리케이션 에 파일 다이제스트가 필요한 경우 이 프로세스 GridFS 외부에서 구현 하고 메타데이터 에 값을 저장 해야 합니다.

    • contentType 및 aliases 필드는 더 이상 files GridFS 컬렉션 에 저장되지 않습니다. 애플리케이션 에 이 정보가 필요한 경우 메타데이터 에 저장 해야 합니다. GridFS 에 대해 자세히 학습 대용량 파일 저장 가이드 참조하세요.

  • 찾기 작업에 대해 더 이상 사용되지 않는 다음 옵션을 제거합니다.

    • maxScan

    • modifiers

    • oplogReplay

    • snapshot

    찾기 작업에 지원되는 옵션에 대해 MongoDB\Collection::find() 학습 또는 API 설명서를 참조하세요.MongoDB\Collection::findOne()

  • 더 이상 사용되지 않는 IndexInfo::isGeoHaystack() 메서드를 제거합니다.

  • MongoDB\Database::createCollection() 메서드에 대해 더 이상 사용되지 않는 autoIndexId 및 flags 옵션을 제거합니다.

  • 더 이상 사용되지 않는 다음 메서드 및 유형을 제거하여 맵 리듀스 기능에 대한 지원 중단합니다.

    • MongoDB\Collection::mapReduce()

    • MongoDB\MapReduceResult

    $group 및 $merge와 같은 집계 파이프라인 단계 사용하여 맵 리듀스 작업을 다시 작성할 수 있습니다. 자세한 학습 은 MongoDB Server 매뉴얼에서 집계 파이프라인으로의 맵 리듀스 를 참조하세요.

  • 다음 Iterator 구현을 제거합니다.

    • MongoDB\Model\CollectionInfoIterator

    • MongoDB\Model\DatabaseInfoIterator

    • MongoDB\Model\IndexInfoIterator

    MongoDB\Client::listDatabases(), MongoDB\Database::listCollections() 및 MongoDB\Collection::listIndexes() 메서드는 해당 결과를 제공하는 일반 순회 가능한 Iterator 인스턴스를 반환합니다.

1.21의 새로운 기능

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

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

1.20의 새로운 기능

중요

MongoDB Server v3.6 수명 종료

이 출시하다 의 라이브러리에서는 MongoDB Server v3.6 에 대한 지원이 제거되었습니다.

  • 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() 메서드에 대한 검색 인덱스 사양에 옵션을 추가합니다. 이 변경을 통해 프로그래밍 방식으로 MongoDB Vector Search 검색 인덱스를 만들 수 있습니다. 자세한 내용을 학습 예시를 보려면 MongoDB 검색 인덱스 가이드 참조하세요.

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

1.19의 새로운 기능

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

1.18의 새로운 기능

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

1.17의 새로운 기능

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

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

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

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

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

돌아가기
Symfony를 사용한 Queryable Encryption
다음
업그레이드
이 페이지 평가하기

이 페이지의 내용