Menu Docs
Página inicial do Docs
/
Línguas
/
PHP
/
Manual da Biblioteca PHP
/
Conecte-se ao MongoDB

Criar um cliente MongoDB

Nesta página

  • Visão geral
  • URI de conexão
  • Criar um MongoDBClient
  • Documentação da API

Visão geral

Para se conectar a uma MongoDB deployment, você deve criar os seguintes itens:

  • O URI de conexão, também conhecido como string de conexão, informa à biblioteca PHP a qual sistema do MongoDB se conectar.

  • objeto MongoDB \Client , que cria a conexão com a implantação do MongoDB e permite que você execute operações nele.

Você também pode definir opções em um ou em ambos os componentes para personalizar a maneira como a biblioteca PHP se comporta enquanto conectada ao MongoDB.

Este guia descreve os componentes de uma string de conexão e mostra como usar um objeto MongoDB\Client para se conectar a um MongoDB deployment.

URI de conexão

Uma connection string padrão inclui os seguintes componentes:

Componente
Descrição
mongodb://
Obrigatório. Um prefixo que identifica isso como uma string no formato de conexão padrão.
db_username:db_password
Opcional. Credenciais de autenticação. Se você incluir estes, o cliente autenticará o usuário no banco de dados especificado no authSource. Para mais informações sobre a opção de conexão do authSource , consulteMecanismos de Autenticaçãodo .
host[:port]
Obrigatório. O host e o número da porta opcional em que o MongoDB está sendo executado. Se você não incluir o número da porta, o driver usará a porta padrão, 27017.
/defaultauthdb
Opcional. O authentication database de autenticação a ser usado se a connection string incluir as credenciais de autenticação db_username:db_password@ , mas não a opção authSource . Se você não incluir este componente, o cliente autenticará o usuário no banco de dados do admin .
?<options>
Opcional. Uma string de consulta que especifica opções específicas de conexão como <name>=<value> pares. Consulte Especificar opções de conexão para obter uma descrição completa dessas opções.

Para saber mais sobre connection strings, consulte connection strings no manual do servidor.

Criar um MongoDBClient

Para criar uma conexão com o MongoDB, passe sua string de conexão ao construir uma instância da classe MongoDB\Client .

No exemplo a seguir, a biblioteca usa um URI de conexão de exemplo para se conectar a uma implementação do MongoDB na porta 27017 de localhost:

<?php
$client = new MongoDB\Client("mongodb://localhost:27017");

Documentação da API

Para saber mais sobre como criar um objeto MongoDB\Client na biblioteca PHP, consulte a seguinte documentação da API:

Voltar

Conecte-se ao MongoDB