新增功能

1.20版本更新内容

• 添加了对MongoDB Server v8.0的支持。

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

• 当分片集群操作失败时，如果其他mongos服务器可用，则库避免选择相同的mongos服务器进行操作重试尝试。mongos服务器。

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

有关本版本更改的更多信息，请参阅GitHub上的v1.20版本说明。

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

要了解更多关于此版本的信息，请参阅 GitHub 上的 v1.18 版本说明。

1.17 新特性

• 引入了一个新的 "codec" API，用于将 BSON 转换为 PHP 对象以及从 PHP 对象转换为 BSON。更多关于此功能的信息可以在 Codec 教程 中找到。

• 向库中添加了 MongoDB\add_logger() 和 MongoDB\remove_logger() 函数。这些函数允许应用程序注册一个 PSR-3 Logger 来接收由驱动程序发出的日志消息。之前，日志只能通过扩展的 mongodb.debug INI 设置来访问。

• 引入了新的 MongoDB\Collection 方法来创建和管理 Atlas Search 索引。可以使用支持所有库版本的 $search 聚合管道阶段查询 Atlas Search 索引。有关 Atlas Search 索引和 $search 聚合阶段的详细信息，请参阅 Atlas Search 索引 文档和 $search.

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

想了解更多关于此次发布的信息，请参阅GitHub上的v1.17 发布说明。