Criar um cliente MongoDB
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 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:
$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: