新增功能

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查询。要学习；了解更多信息，请参阅Atlas Search和Atlas Vector Search指南。

• 弃用了 flags 选项，该选项用于已弃用的 MMAPv1存储引擎。此选项将在PHP库 v2.0 中删除。

• 为MongoDB\Collection::updateOne() 和MongoDB\Collection::replaceOne() 方法添加排序选项。此更改还允许您在批量操作中执行更新和替换操作时将排序顺序设立为选项。

有关此版本中更改的更多信息，请参阅 v1.21 发布说明 在Github 上。

1.20 中的新功能

• 新增支持MongoDB Server v 8.0的支持。

• 添加支持可查询Queryable Encryption(QE)范围查询的支持。 要使用此功能，您的应用必须连接到MongoDB Server 8.0或更高版本。 有关 QE范围查询的更多信息，请参阅MongoDB Server手册中的可查询Queryable Encryption。

• 当分片集群操作不成功时，如果有其他mongos服务器可用，则该库会避免选择相同的mongos服务器进行操作重试。

• 创建 KMIP 数据密钥时，现在可以指定delegated选项。 如果此选项设立为true ，则 KMIP提供商在本地执行数据密钥的加密和解密，确保加密密钥永远不会离开 KMIP服务器。

• 在MongoDB\Collection::createIndex() 和MongoDB\Collection::createSearchIndexes() 方法的搜索索引规范中添加type 选项。此更改允许您以编程方式创建Atlas Vector Search索引。要学习；了解更多信息和查看示例，请参阅Atlas Search索引指南。

有关此版本中更改的更多信息，请参阅 v1.20 发布说明 在Github 上。

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对象的监控类。

要学习；了解有关此发布的更多信息，请参阅 v1.18 发布说明 在Github 上。

1.17 中的新功能

• 引入新的“编解码器” API ，用于在BSON与PHP对象之间进行转换。 有关此功能的更多信息，请参阅编解码器教程。

• 将MongoDB\add_logger()和MongoDB\remove_logger()函数添加到库中。 这些函数允许应用程序注册 PSR-3 记录器 接收驾驶员发出的日志消息。以前，日志只能通过扩展的 mongodb.debugINI 设置。

• 引入新的MongoDB\Collection方法来创建和管理Atlas Search索引。 可以使用$search聚合管道阶段来查询Atlas Search索引，该库的所有版本都支持该阶段。 要学习；了解有关Atlas Search索引和$search聚合阶段的详情的更多信息，请参阅Atlas Search索引文档和$ 搜索。

• 将mongodb扩展要求升级到1.17.0 。 对PHP 7.2和7.3的支持已删除，该库现在需要PHP 7.4或更高版本。

要学习；了解有关此发布的更多信息，请参阅 v1.17 发布说明 在Github 上。