ライブラリのバージョンをアップグレードする

Overview

このページでは、 MongoDB PHPライブラリの新しいバージョンにアップグレードするときにアプリケーションに加える必要がある変更の詳細を確認できます。 このページには、 PHP拡張機能を新しいバージョンにアップグレードする方法も含まれています。

アップグレード方法

アップグレードする前に、次のアクションを実行してください。

• 新しいPHPライブラリ バージョンが、アプリケーションが接続するMongoDB Serverのバージョンと、アプリケーションがコンパイルされるPHPバージョンと互換性があることを確認します。 バージョンの互換性情報については、 MongoDB PHPライブラリの互換性ページを参照してください。

• アプリケーションが使用しているライブラリ バージョンとアップグレード予定のバージョンとの間の重大な変更については、 重大な変更セクションを参照してください。

PHP拡張機能とライブラリのメジャー バージョンとマイナー バージョンは同期されます。 つまり、拡張機能に対してアップグレード コマンドを実行すると、 PHPライブラリもアップグレードされます。

ライブラリと拡張機能のパッチ バージョン（XXXX）は同期されていません。 ライブラリまたは拡張機能のパッチ バージョンに更新するには、それぞれのコマンドを実行します。

PHP拡張機能をアップグレードするには、 <version-number>をアップグレードするバージョン番号に置き換え、アプリケーションのディレクトリで次のコマンドを実行します。

pecl upgrade mongodb-<version-number>

PHPライブラリのバージョンをアップグレードするには、 <version-number>をアップグレードするバージョン番号に置き換え、アプリケーションのディレクトリで次のコマンドを実行します。

composer require mongodb/mongodb:<version-number>

インストールの詳細な手順については、 PHP.net ドキュメント を参照してください。

重大な変更

重大な変更とは、特定のバージョンのライブラリ以降の 規則 または 動作 の変更です。 このタイプの変更では、ライブラリをアップグレードする前に処理されない場合、アプリケーションが正常に動作しなくなる可能性があります。

このセクションの重大な変更は、それを導入したライブラリのバージョンによって分類されます。 ライブラリのバージョンをアップグレードするときは、現在のバージョンとアップグレード バージョン間のすべての重大な変更に対処してください。

リリース変更の詳細については、 の各リリースのリリースノートと関連する JIRAGithub チケットを参照してください。