Menu Docs
Página inicial do Docs
/
Drivers

Driver PHP do MongoDB

Bem-vindo ao site de documentação do driver PHP oficial da MongoDB. Você pode adicionar o driver ao seu aplicativo para trabalhar com MongoDB em PHP. O driver MongoDB PHP consiste nos seguintes componentes:

  • Extensão: fornece uma API de baixo nível e serve principalmente para integrar as bibliotecas libmongoc e libbson com PHP.

  • Biblioteca: fornece uma API de alto nível para trabalhar com bancos de dados do MongoDB, consistente com outros drivers de linguagem do MongoDB.

Embora seja possível usar apenas a extensão, recomendamos usar a extensão e a biblioteca juntas. Para saber mais sobre os componentes do driver PHP, consulte a seção Arquitetura do driver desta página.

Consulte os seguintes guias para saber mais sobre o driver e acessar o conteúdo do tutorial sobre como configurar um projeto executável:

Esta seção descreve como os componentes do driver PHP trabalham juntos. Esses componentes se encaixam nas seguintes categorias gerais:

  • API de alto nível, que inclui a biblioteca e outras integrações

  • Extensão, que inclui a extensão que integra as bibliotecas de sistemas

  • Sistema, que inclui o C Driver, a biblioteca BSON e a biblioteca de criptografia

O diagrama a seguir ilustra a arquitetura dos componentes do driver PHP:

Arquitetura de componentes do driver PHP

A biblioteca PHP fornece uma API consistente com os outros drivers do MongoDB. A biblioteca é atualizada continuamente para atender às especificações de vários drivers. Você deve adicionar a biblioteca como uma dependência para acessar o MongoDB na maioria dos aplicativos PHP.

A extensão é distribuída por meio do PECL e conecta o PHP às bibliotecas do sistema. A API pública da extensão fornece a seguinte funcionalidade:

  • Gerenciamento de conexões

  • Codificação e decodificação BSON

  • Serialização de documento de objeto

  • Execução de comandos

  • Gerenciamento do cursor

Para saber mais sobre as bibliotecas de sistemas, consulte a documentação do Driver C.

Você pode usar o driver PHP para se conectar a implementações hospedadas nos seguintes ambientes:

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

  • MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

  • MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Certifique-se de ter uma versão recente do PHP instalada em seu sistema. Consulte o manual do PHP para obter instruções de download e instalação.

Instale a extensão PHP do MongoDB antes de instalar a biblioteca PHP do MongoDB. Você pode instalar a extensão usando o PECL na linha de comando:

sudo pecl install mongodb

Adicione a seguinte linha ao seu arquivo php.ini após a conclusão da instalação:

extension=mongodb.so

Observação

Em alguns sistemas, pode haver vários arquivos .ini para SAPIs individuais, como CLI e FPM. Certifique-se de habilitar a extensão em todos os SAPIs que você utiliza.

Em seguida, instale a biblioteca PHP usando Composer. Execute o seguinte comando no diretório do seu projeto:

composer require mongodb/mongodb

Após a conclusão da instalação, certifique-se de que seu aplicativo inclua o carregador automático do Composer, conforme mostrado no exemplo a seguir:

<?php
require_once __DIR__ . '/vendor/autoload.php';

A documentação da biblioteca PHP contém materiais de referência e tutoriais que demonstram como realizar a interação com seus dados do MongoDB.

Devido a possíveis problemas que representam inteiros de 64 bits em plataformas de 32 bits, os usuários são aconselhados a usar ambientes de 64 bits. Ao utilizar uma plataforma de 32 bits, esteja ciente de que qualquer leitura de inteiro de 64bits do banco de dados será retornada como uma instância MongoDB\BSON\Int64 em vez de um tipo inteiro PHP.

A tabela de compatibilidade a seguir especifica a versão ou as versões recomendadas do driver PHP para usar com uma versão específica do MongoDB.

A primeira coluna lista a versão do driver.

Importante

O MongoDB garante a compatibilidade entre o MongoDB Server e os drivers por três anos após a data de fim da vida útil (EOL) da versão do servidor. Para saber mais sobre a versão do MongoDB e as datas de EOL, consulte Agendamentos do ciclo de vida do software MongoDB.

Versões do driver PHP
MongoDB 8.0
MongoDB 7.0
MongoDB 6.0

ext + lib 1.20 a 2.1

ext + lib 1.16 a 1.19

ext + lib 1.15

A tabela de compatibilidade a seguir especifica a versão ou as versões recomendadas do driver PHP para usar com uma versão específica do PHP.

A primeira coluna indica as versões do driver.

Versões do driver PHP
PHP 8.4
PHP 8.3
PHP 8.2
PHP 8.1
PHP 8.0
PHP 7.4
PHP 7.3
PHP 7.2

ext + lib 1.21 a 2.1

ext + lib 1.20

ext + lib 1.17 a 1.19

ext + lib 1.16

ext + lib 1.15

Para obter mais informações sobre como ler as tabelas de compatibilidade, consulte nosso guia em tabelas de compatibilidade do MongoDB.

Voltar

Drivers Kotlin

Nesta página