Escolha um destino de conexão

Visão geral

Neste guia, você pode aprender como usar uma string de conexão e objeto MongoDB\Client para conectar a diferentes tipos de sistemas MongoDB.

Atlas

Para se conectar a uma MongoDB deployment no Atlas, inclua os seguintes elementos em sua connection string:

• URI do seu Atlas cluster

• Nome de usuário do banco de dados

• Senha do usuário do banco de dados

Em seguida, passe sua connection string para o construtor MongoDB\Client .

Ao se conectar ao Atlas, recomendamos usar a opção de cliente Stable API para evitar alterações significativas quando o Atlas atualizar para uma nova versão do servidor MongoDB. Para saber mais sobre o recurso de API estável, consulte a página de API estável .

O código abaixo mostra como usar a biblioteca PHP para se conectar a um Atlas cluster. O código também usa a opção serverApi para especificar uma versão da API estável.

<?php
// Replace the placeholder with your Atlas connection string
$uri = '<connection string>';
// Create a MongoDB client with server API options
$client = new MongoDB\Client($uri, [], [
    'serverApi' => new MongoDB\Driver\ServerApi('1')
]);
// Ping the server to verify that the connection works
$admin = $client->admin;
$command = new MongoDB\Driver\Command(['ping' => 1]);
$result = $admin->command($command)->toArray();
echo json_encode($result), PHP_EOL;
echo 'Pinged your deployment. You successfully connected to MongoDB!\n';

Sistemas locais

Para se conectar a uma implantação local do MongoDB, use localhost como nome do host. Por padrão, o processo mongod é executado na porta 27017, embora você possa personalizar isso para seu sistema.

O seguinte código mostra como usar a biblioteca PHP para se conectar a uma implementação local do MongoDB :

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

Conjuntos de réplicas

Para se conectar a um conjunto de réplicas, especifique o nome de host (ou o endereço IP) e o número de porta dos membros do conjunto de réplicas em sua string de conexão.

Se você não conseguir fornecer uma lista completa de hosts no conjunto de réplicas, poderá especificar um ou mais hosts no conjunto de réplicas e instruir a biblioteca PHP a executar a descoberta automática para encontrar os outros. Para instruir o driver a executar a descoberta automática, escolha uma das seguintes ações:

• Especifique o nome do conjunto de réplica como o valor do parâmetro replicaSet.

• Especifique false como o valor do parâmetro directConnection.

• Especifique mais de um host no conjunto de réplica.

No exemplo a seguir, o driver usa um URI de conexão de exemplo para se conectar ao conjunto de réplicas do MongoDB sampleRS, que está sendo executado na porta 27017 de três hosts diferentes, incluindo host1:

<?php
$uri = 'mongodb://host1:27017/?replicaSet=sampleRS';
// Create a MongoDB client
$client = new MongoDB\Client($uri);

<?php
// Replace the placeholders with your actual hostname and port
$uri = 'mongodb://<hostname>:<port>/?directConnection=true';
// Create a MongoDB client
$client = new MongoDB\Client($uri);

Documentação da API

Para saber mais sobre como usar a classe MongoDB\Client , consulte a seguinte documentação da API:

• MongoDB\Client