Atualizar versões da biblioteca

Visão geral

Nesta página, você pode aprender sobre as alterações que deve fazer no seu aplicação ao atualizar para uma nova versão da Biblioteca PHP do MongoDB . Esta página também inclui como atualizar sua extensão PHP para uma nova versão.

Como fazer a atualização

Antes de atualizar, execute as seguintes ações:

• Resolva quaisquer alterações significativas entre a versão da biblioteca que seu aplicação está usando e a versão de atualização planejada na seção Alterações significativas.

• Certifique-se de que a nova versão da biblioteca PHP seja compatível com as versões do MongoDB Server às quais seu aplicativo se conecta e com a versão do PHP com a qual seu aplicativo é compilado. Para obter informações sobre compatibilidade de versão, consulte a seção Alterações de compatibilidade e a página Compatibilidade.

Versões principais e secundárias da extensão e biblioteca PHP estão sincronizadas. Isso significa que você pode executar um comando de atualização para a extensão para também atualizar a biblioteca PHP.

As versões de patch (XXX) para a biblioteca e extensão não estão em sincronizadas. Execute os respectivos comandos para atualizar para as versões de patch da biblioteca ou extensão.

Para atualizar a extensão PHP, substitua <version-number> pelo número da versão para a qual você deseja atualizar e execute o seguinte comando no diretório do seu aplicativo:

pie install mongodb/mongodb-extension:^<version-number>

pecl upgrade mongodb-<version-number>

Para atualizar a versão da biblioteca PHP, substitua <version-number> pelo número da versão para a qual você deseja atualizar e execute o seguinte comando no diretório do seu aplicativo:

composer require mongodb/mongodb:<version-number>

Instruções de instalação detalhadas podem ser encontradas na documentação do PHP.net.

Mudanças de última hora

Uma alteração interruptiva significativa é uma alteração de uma convenção ou comportamento a partir de uma versão específica da biblioteca. Esse tipo de alteração pode impedir que seu aplicação funcione corretamente se não for resolvido antes de atualizar a biblioteca.

As mudanças significativas nesta seção são categorizadas pela versão da biblioteca que as introduziram. Somente as versões principais da biblioteca introduzem alterações significativas. Ao atualizar versões, resolva todas as alterações significativas entre a versão atual e a atualizada.

Para obter mais informações sobre as alterações de versão, consulte as notas de versão e os tickets JIRA associados para cada versão no Github.

Alterações de compatibilidade

Esta seção descreve as alterações de compatibilidade do MongoDB Server e PHP introduzidas nas versões da Biblioteca PHP do MongoDB .