Notas de versão

Novidades no 2.1

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

• Adiciona compatibilidade com PHP 8.5.

• Adiciona uma API de gravação em massa do cliente para executar operações de gravação em vários bancos de dados e coleções na mesma chamada. Para saber mais sobre esse recurso, consulte a seção Gravação em massa do cliente do guia Operações de gravação em massa.

Novidades no 2.0

A versão da biblioteca PHP v2.0 inclui as seguintes alterações e remoções de API:

• Adiciona os seguintes métodos:

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

  • MongoDB\Client::getCollection(): alias para MongoDB\Client::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.

• Modifica os métodos MongoDB\Database::aggregate() e MongoDB\Collection::aggregate() para que eles possam aceitar uma instância Pipeline como o parâmetro $pipeline. Para visualizar exemplos que usam essa construção, consulte a seção Construtor de aggregation do guia Agregação.

• Substitui dicas de tipo Cursor por CursorInterface para melhor extensibilidade e compatibilidade.

• Remove campos obsoletos em tipos de GridFS .

  • A biblioteca não calcula o campo md5 quando um arquivo é carregado no GridFS. Se o seu aplicação exigir um resumo do arquivo, você deverá implementar esse processo fora do GridFS e armazenar os valores em metadados.

  • Os campos contentType e aliases não são mais armazenados na coleção files do GridFS . Se seu aplicação exigir essas informações, você deverá armazená-las em metadados. Para saber mais sobre o GridFS, consulte o guia Armazenar arquivos grandes.

• Remove as seguintes opções obsoletas para operações de localização:

  • maxScan

  • modifiers

  • oplogReplay

  • snapshot

  Para saber mais sobre as opções compatíveis com operações de localização, consulte a MongoDB\Collection::find() ou MongoDB\Collection::findOne() documentação da API.

• Remove o método IndexInfo::isGeoHaystack() obsoleto.

• Remove as opções autoIndexId e flags obsoletas do método MongoDB\Database::createCollection().

• Elimina o suporte para a funcionalidade de map-reduce removendo os seguintes métodos e tipos obsoletos:

  • MongoDB\Collection::mapReduce()

  • MongoDB\MapReduceResult

  Você pode reescrever operações de map-reduce usando agregação pipeline stages , como $group e $merge. Para saber mais, consulte Map-reduce to aggregation pipeline no manual do MongoDB Server.

• Remove as seguintes implementações do Iterator:

  • MongoDB\Model\CollectionInfoIterator

  • MongoDB\Model\DatabaseInfoIterator

  • MongoDB\Model\IndexInfoIterator

  Os métodos MongoDB\Client::listDatabases(), MongoDB\Database::listCollections() e MongoDB\Collection::listIndexes() retornam uma instância geral traversable Iterator que fornece os resultados correspondentes.

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 SearchStage VectorSearchStage SearchMetaStage classes de construtor, e. Essa alteração permite que você escreva queries 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 query de Vector Search 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 type opção nas especificações de índice de pesquisa para os métodos e. Essa alteração permite criar índices do MongoDB Vector MongoDB\Collection::createIndex() Search programaticamente. Para saber mais e ver MongoDB\Collection::createSearchIndexes() exemplos, consulte o guia de índices de pesquisa do MongoDB .

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 para criar e gerenciar índices de pesquisa MongoDB . Os índices do MongoDB Search podem ser consultados usando MongoDB\Collection o $search estágio de pipeline de agregação, que é suportado em todas as versões da biblioteca. Para saber mais sobre os índices do MongoDB Search e as especificidades do $search estágio de agregação, consulte a documentação dos índices 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.