升级库版本

概述

在本页中，您可以了解在升级到 MongoDB PHP 库的新版本时，需要对应用程序进行的更改。本页还包括如何升级 PHP 扩展到新版本。

如何升级

在升级之前，请执行以下操作

• 确保新的 PHP 库版本与您的应用程序连接的 MongoDB 服务器版本以及与您的应用程序编译的 PHP 版本兼容。有关版本兼容性信息，请参阅MongoDB PHP 库兼容性页面。

• 在破坏性更改部分中处理应用程序使用的库版本和您计划升级的版本之间的任何破坏性更改。

PHP 扩展和库的主要版本和次要版本同步。这意味着您可以运行扩展的升级命令来升级 PHP 库。

库和扩展的补丁版本（x.x.x）不同步。运行相应的命令以更新库或扩展的补丁版本。

要升级 PHP 扩展，将<version-number>替换为您想要升级到的版本号，并在您的应用程序目录中运行以下命令

pecl upgrade mongodb-<version-number>

要升级 PHP 库版本，将 <version-number> 替换为您想要升级到的版本号，并在您的应用程序目录中运行以下命令

composer require mongodb/mongodb:<version-number>

详细的安装说明可以在 PHP.net 文档 中找到。

重大变更

重大变更是指从库的特定版本开始，对约定或行为的更改。如果在不升级库之前不解决这个问题，此类更改可能会阻止应用程序正常运行。

本节中的重大变更按引入它们的库版本进行分类。在升级库版本时，解决当前版本和升级版本之间的所有重大变更。

有关发布变更的更多信息，请参阅每个发布的发布说明和相关的 JIRA 票据，请访问 GitHub