Notas de versão

Novidades no 1.21

A versão da biblioteca PHP v1.21 inclui as seguintes funcionalidades, melhorias e correções:

• Apresenta o Aggregation Builder, uma API para criar agregação pipelines de uma forma mais segura de tipo. Para saber mais e ver exemplos, consulte a seção Construtor de aggregation do guia Agregação.

• Adiciona os seguintes métodos:

  • MongoDB\Client::getDatabase(): alias para MongoDB\Client::selectDatabase()

  • MongoDB\Database::getCollection(): alias para MongoDB\Database::selectCollection()

  • MongoDB\Database::getCollection(): alias para MongoDB\Database::selectCollection()

  Os métodos Client::selectCollection(), Client::selectDatabase() e Database::selectCollection() serão descontinuados e substituídos por esses novos métodos em uma futura versão do driver, portanto, considere alterar os usos em seu aplicação.

• Adiciona argumentos nomeados para as classes de construtor SearchStage, VectorSearchStage e SearchMetaStage. Essa alteração permite que você escreva query de pesquisa do MongoDB Search e do MongoDB Vector Search de uma maneira mais segura e organizada. Para saber mais, consulte os guias Executar uma query de pesquisa do MongoDB e Executar uma pesquisa vetorial do MongoDB.

• Descontinua a opção flags, usada para o mecanismo de armazenamento MMAPv1 obsoleto. Esta opção será removida na biblioteca PHP v2.0.

• Adiciona uma opção de classificação aos métodos MongoDB\Collection::updateOne() e MongoDB\Collection::replaceOne(). Essa alteração também permite que você defina uma ordem de classificação como uma opção ao executar operações de atualização e substituição em uma operação em massa.

• Adiciona a opção builderEncoder aos seguintes métodos:

  • Database constructor

  • MongoDB\Database::withOptions()

  • Collection constructor

  • MongoDB\Collection::withOptions()

Para obter mais informações sobre as alterações nesta versão, consulte as notas de versão v1.21 no Github.

Novidades no 1.20

• Adiciona suporte para MongoDB Server v8.0.

• Adiciona suporte para queries de intervalo de Queryable Encryption (QE). Para usar esse recurso, seu aplicativo deve se conectar ao MongoDB Server 8.0 ou posterior. Para obter mais informações sobre queries de intervalo de QE, consulte Queryable Encryption no manual do MongoDB Server .

• Quando uma operação de cluster fragmentado não é bem-sucedida, a biblioteca evita selecionar o mesmo servidor mongos para tentativas de repetição de operação se outros servidores mongos estiverem disponíveis.

• Ao criar uma chave de dados KMIP, agora você pode especificar a opção delegated . Se essa opção estiver definida como true, o fornecedor de KMIP executará a criptografia e a descriptografia da chave de dados localmente, garantindo que a chave de criptografia nunca saia do servidor KMIP.

• Adiciona a opção type nas especificações de índice de pesquisa para os métodos MongoDB\Collection::createIndex() e MongoDB\Collection::createSearchIndexes(). Essa alteração permite criar índices de pesquisa MongoDB Vector Search programaticamente. Para saber mais e ver exemplos, consulte o índices de pesquisa do MongoDB guia.

Para obter mais informações sobre as alterações nesta versão, consulte as notas de versão v1.20 no Github.

Novidades no 1.19

Esta versão da biblioteca PHP não contém alterações significativas e foi adicionada para manter a paridade da versão com a extensão PHP.

Novidades no 1.18

• Adiciona uma nova API GridFS para tornar mais conveniente trabalhar com arquivos usando as funções de sistema de arquivos existentes do PHP. O método MongoDB\GridFS\Bucket::registerGlobalStreamWrapperAlias() pode ser utilizado para registrar um alias global para um bucket GridFS . Depois de fazer isso, os arquivos dentro desse bucket podem ser acessados usando apenas um URI de arquivo (por exemplo, "gridfs://mybucket/hello.txt"). Uma demonstração desta API pode ser encontrada no script de exemplo gridfs_stream_wrapper.php.

• Adiciona métodos MongoDB\Client::addSubscriber() e MongoDB\Client::removeSubscriber() à classe MongoDB\Client para facilitar o registro de classes de monitoramento com escopo definido para o objeto MongoDB\Driver\Manager subjacente.

Para saber mais sobre esta versão, consulte as notas de versão v1.18 no Github.

Novidades no 1.17

• Apresenta uma nova API "codec" para converter BSON de e para objetos PHP. Mais informações sobre esse recurso podem ser encontradas no tutorial Codecs.

• Adiciona funções MongoDB\add_logger() e MongoDB\remove_logger() à biblioteca. Essas funções permitem que os aplicativos registrem um PSR-3 Logger para receber mensagens de registro emitidas pelo driver. Anteriormente, os registros só estavam disponíveis por meio da configuração mongodb.debug INI da extensão.

• Introduz novos métodos do MongoDB\Collection para criar e gerenciar índices de pesquisa MongoDB . Os índices de pesquisa do MongoDB podem ser consultados usando a fase do pipeline de agregação $search, que é suportada em todas as versões da biblioteca. Para saber mais sobre os índices de pesquisa do MongoDB Search e as especificidades do estágio de agregação $search, consulte a documentação dos índices de pesquisa do MongoDB Search e $search.

• Atualiza o requisito de extensão mongodb para 1.17.0. O suporte para PHP 7.2 e 7.3 foi removido e a biblioteca agora requer PHP 7.4 ou mais recente.

Para saber mais sobre esta versão, consulte as notas de versão v1.17 no Github.