リリースノート

2.4.2の新機能

PHPライブラリ v2.4.2 のリリースには、次の変更が含まれています。

このバージョンの変更の完全なリストについては GitHub の v..2 リリースノートを参照してください。42

2.4.1の新機能

PHPライブラリ v2.4.1 のリリースには、次の変更が含まれています。

このバージョンの変更の完全なリストについては GitHub の v..2 リリースノートを参照してください。41

2.4の新機能

PHPライブラリ v2.4 リリースには、次の機能、改善点、修正が含まれています。

• ビルダ API で、$rerank 集計パイプライン ステージのサポートを追加します。Stage::rerank() ファクトリ メソッドを使用して、Voyage AI の 再ランキング モデル を使用して入力ドキュメントの順序を変更し、同じドキュメントを関連度でソートして返すことができます。

• MongoDB ベクトル検索インデックス定義における storedSource オプションのサポートを追加します。このオプションを使用すると、指定したフィールドのコピーをインデックスに保存できます。これにより、クエリ時の取得が高速化されます。詳細については、MongoDB 検索インデックス ガイドのstoredSource オプションの使用を参照してください。

• 新しい $convert 機能のビルダサポートを追加します。$convert を使用して、次の操作を実行できます。

  • 数値の基数変換を実行します。

  • あらゆる型を string に変換します。

  • JSON string を配列またはオブジェクトに変換します。

• $subtype のサポートを追加します。これにより、BinData 値のサブタイプ整数が返されます。

• $createObjectId のサポートを追加します。これによりランダムな ObjectId 値が生成されます。

• 集計 string 式での正規表現のサポートを追加します。$replaceOne と $replaceAll の find 引数で、また $split の区切り記号として正規表現を使用できるようになりました。

このバージョンの変更の完全なリストについては GitHub の2 v.4 リリースノートを参照してください。

2.3の新機能

PHPライブラリ v2.3 リリースには、次の機能、改善点、修正が含まれています。

• Builder APIでアトミックな更新演算子のサポートを追加します。MongoDB\Builder\Updateクラスのファクトリー メソッドを使用して、コード完了とタイプ チェックを使用して更新 ドキュメントを構築できます。詳しくは、 ドキュメント更新ガイドの「更新ビルダ」セクションを参照してください。

• PHP拡張要件をバージョン 2.3 以降にアップグレードします。

• MongoDB Server v4.2 のサポートを廃止します。PHPライブラリの今後のバージョンにはMongoDB Server v4.4 以降が必要です。

• enableOverloadRetargeting および maxAdaptiveRetries URI オプションを追加します。これらのオプションは、ドライバーが過負荷のサーバーに遭遇した場合の再試行動を制御します。また、MongoDB 9.0 以降のみサポートされています。詳細については、サーバーの選択と検出オプションを参照してください。

このバージョンの変更の詳細については GitHub の2 v.3 リリースノートを参照してください。

2.2の新機能

PHPライブラリ v2.2 リリースには、次の機能、改善点、修正が含まれています。

• ランダムな ObjectID を生成するための $createObjectIds集計パイプライン演算子のサポートを追加します。

• $concatArrays と $setUnion集計アキュムレータのサポートを追加します。

• $scoreFusionパイプラインステージのサポートを追加します。

• パイプライン更新を使用する際に MongoDB\Collection::findOneAndUpdate() メソッドで Pipelineインスタンスを渡すことができるようになります。

• 新しい MongoDB\Model\CollectionInfo::isView() メソッドを MongoDB\Model\CollectionInfoクラスに追加します。

• MongoDB\Database::getCollection() との整合性のための MongoDB\Database::getGridFSBucket() メソッドを追加します。

2.1の新機能

PHPライブラリ v2.1 リリースには、次の機能、改善点、修正が含まれています。

• PHP 8.5 との互換性を追加します。

• 複数のデータベースとコレクションに対する書き込み操作を同じ呼び出しで実行するためのクライアント一括書き込みAPIを追加します。この機能の詳細については、 一括書込み操作ガイドの「クライアント一括書込み」セクションを参照してください。

2.0の新機能

PHPライブラリ v2.0 リリースには、次のAPI の変更と削除が含まれています。

• 次のメソッドを追加します。

  • MongoDB\Client::getDatabase(): のエイリアス MongoDB\Client::selectDatabase()

  • MongoDB\Client::getCollection(): のエイリアス MongoDB\Client::selectCollection()

  • MongoDB\Database::getCollection(): のエイリアス MongoDB\Database::selectCollection()

  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() または MongoDB\Collection::findOne() APIドキュメントを参照してください。

• 非推奨の IndexInfo::isGeoHaystack() メソッドを削除します。

• MongoDB\Database::createCollection() メソッドの非推奨の autoIndexId オプションと flags オプションを削除します。

• 次の非推奨のメソッドとタイプを削除することで、 map-reduce機能のサポートを廃止します。

  • MongoDB\Collection::mapReduce()

  • MongoDB\MapReduceResult

  map-reduce操作は、$group や $merge などの集計パイプラインステージ を使用して書き換えることができます。詳細については、 MongoDB Serverマニュアルのmap-reduce から集計パイプラインへの移行を参照してください。

• 次の 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 リリースには、次の機能、改善点、修正が含まれています。

• 集計パイプラインをよりタイプセーフな方法で構築するためのAPIである Aggregation Builder を導入します。詳細と例については、集計ガイドの「集計ビルダ」セクションを参照してください。

• 次のメソッドを追加します。

  • 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 ビルダ クラスの名前付き引数を追加します。この変更により、MongoDB Search および MongoDB ベクトル検索の検索クエリをより型安全で整理された方法で記述できます。詳細については、MongoDB 検索クエリを実行するおよびMongoDB ベクトル検索クエリを実行するガイドを参照してください。

• 非推奨の MMAPv1 ストレージエンジンで使用される flags オプションを廃止します。このオプションは、 PHPライブラリ v2.0 で削除されます。

• MongoDB\Collection::updateOne() メソッドと MongoDB\Collection::replaceOne() メソッドにソート オプションを追加します。この変更により、 一括操作でアップデート操作と置換操作を実行するときに、オプションとしてソート順序を設定できるようになります。

• 次のメソッドに builderEncoder オプションを追加します。

  • Database constructor

  • MongoDB\Database::withOptions()

  • Collection constructor

  • MongoDB\Collection::withOptions()

このバージョンの変更の詳細については GitHub の1 v.21 リリースノートを参照してください。

1.20の新機能

• MongoDB Server v 8.0のサポートを追加します。

• Queryable Encryption（QE）範囲クエリのサポートを追加します。 この機能を使用するには、アプリを MongoDB Server 8.0以降に接続する必要があります。 QEQueryable Encryption 範囲クエリの詳細については、MongoDB Server マニュアルの「 」を参照してください。

• シャーディングされたシャーディングされたクラスター操作が成功しない場合、ライブラリは他のmongosサーバーが使用可能な場合、操作の再試行に同じmongosサーバーを選択することを回避します。

• KMIP データキーを作成する際に、 delegatedオプションを指定できるようになりました。 このオプションをtrueに設定すると、KMIP プロバイダーはデータキーの暗号化と復号化をローカルで実行し、暗号化のキーが KMIPサーバーから離れることはありません。

• typeメソッドとMongoDB\Collection::createIndex()MongoDB\Collection::createSearchIndexes() メソッドの検索インデックス仕様に オプションを追加します。この変更により、 MongoDB ベクトル検索インデックスをプログラムで作成できるようになります。詳細と例については、MongoDB 検索インデックスガイドを参照してください。

このバージョンの変更の詳細については GitHub の1 v.20 リリースノートを参照してください。

1.19の新機能

PHPライブラリのこのリリースでは大きな変更は含まれておらず、 PHP拡張機能とバージョンの同等性を保つために追加されています。

1.18の新機能

• PHP の既存のファイルシステム関数を使用してファイルを操作しやすくするために、新しいGridFS APIを追加します。MongoDB\GridFS\Bucket::registerGlobalStreamWrapperAlias() メソッドを使用して、 GridFSバケットのグローバル エイリアスを登録できます。そうすると、そのバケット内のファイルにはファイルURI のみを使用してアクセスできるようになります（例:" Gridds://mybucket/hello.txt "）。このAPIのデモは、 gridfs_stream_wrapper.php 例スクリプトにあります。

• 基礎のMongoDB\Driver\Managerオブジェクトにスコープが設定されたモニタリング クラスの登録を容易にするために、 MongoDB\ClientクラスにMongoDB\Client::addSubscriber() } メソッドとMongoDB\Client::removeSubscriber()メソッドを追加します。

このリリースの詳細については GitHub の1 v.18 リリースノートを参照してください。

1.17の新機能

• BSONとPHPオブジェクトを変換するための新しい「コーデック」 APIを導入します。 この機能の詳細については、「コーデック チュートリアル」を参照してください。

• MongoDB\add_logger()ライブラリにMongoDB\remove_logger() と 関数を追加します。これらの関数を使用すると、アプリケーションは PSR-3 Logger を登録し、ドライバーが出力するログメッセージを受信できるようにします。以前は、ログは 拡張機能の mongodb.debugINI 設定でのみ利用可能でした。

• MongoDB 検索インデックスを作成および管理するための新しい MongoDB\Collection メソッドを導入します。MongoDB 検索インデックスは、ライブラリのすべてのバージョンでサポートされている $search集計パイプライン ステージを使用してクエリできます。MongoDB 検索インデックスと $search 集計ステージの詳細については、MongoDB 検索インデックス のドキュメントおよび $search を参照してください。

• mongodbの拡張要件を1.17.0にアップグレードします。 PHP 7.2および7.3のサポートは削除され、ライブラリにはPHP 7.4以上が必要になりました。

このリリースの詳細については GitHub の1 v.17 リリースノートを参照してください。