Driver PHP do MongoDB

Introdução

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:

• Comece com a Biblioteca PHP

• Conecte-se ao MongoDB

Arquitetura de driver

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:

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.

Conecte-se a uma implantação compatível do MongoDB

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

Instalação

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

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.

Compatibilidade

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.