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:

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

• 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.

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:

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. Ao atualizar as versões da biblioteca, 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.