Notas de versão

Novidades em 2.4.2

A biblioteca PHP v2.4.2 inclui a seguinte alteração:

Para obter uma lista completa das alterações nesta versão, consulte as notas de versão24v..2 no GitHub.

Novidades em 2.4.1

A biblioteca PHP v2.4.1 inclui a seguinte alteração:

Para obter uma lista completa das alterações nesta versão, consulte as notas de versão24v..1 no GitHub.

Novidades no 2.4

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

• Adiciona suporte para o $rerank estágio de pipeline de agregação na API do Construtor. Você pode usar o Stage::rerank() método de fábrica para reordenar documentos de entrada usando os modelos de reclassificação do Voyage AI e retornar os mesmos documentos classificados por relevância.

• Adiciona suporte para a opção storedSource nas definições de índice de pesquisa vetorial do MongoDB. Você pode usar esta opção para armazenar cópias de campos especificados no índice para recuperação mais rápida no momento da query. Para saber mais, consulte Usar a opção storedSource no guia Índice de pesquisa do MongoDB.

• Adiciona suporte a construtores para novas funcionalidades $convert. Você pode usar $convert para:

  • Execute conversões numéricas de base.

  • Converter qualquer tipo em string.

  • Converta uma string JSON em um array ou objeto.

• Adiciona suporte para $subtype, que retorna o inteiro do subtipo para um valor BinData.

• Adiciona suporte para $createObjectId, que gera um valor ObjectId aleatório.

• Adiciona suporte para expressões regulares em expressões de string de agregação. Agora você pode usar uma expressão regular nos argumentos find para $replaceOne e $replaceAll, e como delimitador para $split.

Para obter uma lista completa das alterações nesta versão, consulte as notas de2 versão v.4 no GitHub.

Novidades no 2.3

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

• Adiciona suporte para operadores de atualização atômica na API do construtor. Você pode usar métodos de fábrica da classe MongoDB\Builder\Update para construir documentos de atualização com conclusão de código e verificação de tipo. Para **aprender** mais, consulte a seção Atualizar construtor do guia Atualizar documentos.

• Atualiza o requisito de extensão PHP para a versão 2.3 ou posterior.

• Descontinua o suporte para o MongoDB Server v4.2. As próximas versões da biblioteca PHP exigirão o MongoDB Server v4.4 ou posterior.

• Adiciona as opções de URI enableOverloadRetargeting e maxAdaptiveRetries. Essas opções controlam o comportamento de repetição quando o driver encontra servidores sobrecarregados e são compatíveis apenas com o MongoDB 9.0 ou posterior. Para saber mais, consulte Opções de seleção e descoberta de servidor.

Para obter mais informações sobre as alterações nesta versão, consulte as notas de2 versão v.3 no GitHub.

Novidades no 2.2

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

• Adiciona suporte para o operador de pipeline de agregação do $createObjectIds para gerar ObjectIDs aleatórios.

• Adiciona suporte para os acumuladores de agregação do $concatArrays e $setUnion.

• Adiciona suporte para o estágio de pipeline $scoreFusion.

• Permite passar uma instância Pipeline no método MongoDB\Collection::findOneAndUpdate() ao usar atualizações de pipeline.

• Adiciona o novo método MongoDB\Model\CollectionInfo::isView() à classe MongoDB\Model\CollectionInfo.

• Adiciona o método MongoDB\Database::getGridFSBucket() para consistência com MongoDB\Database::getCollection().

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 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 de1 versão v.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 de1 versão v.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 de1 versão do18 v. 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 MongoDB\add_logger() funções e à biblioteca. Essas funções MongoDB\remove_logger() permitem que os3 aplicativos registrem um PSR- Logger para receber mensagens de registro emitidas pelo driver. Anteriormente, os registros só estavam disponíveis por meio da configuração mongodb.debug da INI 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 de1 versão do17 v. no GitHub.