Conectando ao MongoDB
Criando uma instância do cliente
Conexão com servidor independente
Se você não especificar um valor do $uri
, o driver conectará a um mongod
standalone no 127.0.0.1
via porta 27017
. Para conectar a um servidor diferente, passe a connection string correspondente como o primeiro parâmetro ao criar a instância do Client
:
$client = new MongoDB\Client('mongodb://mongodb-deployment:27017');
Conexão com conjunto de réplicas
O exemplo a seguir demonstra como se conectar a um conjunto de réplicas com uma read preference personalizada:
$client = new MongoDB\Client( 'mongodb://rs1.example.com,rs2.example.com/?replicaSet=myReplicaSet', [ 'readPreference' => 'secondaryPreferred', ] );
Conexão com com SSL e autenticação
O seguinte exemplo demonstra como se conectar a um conjunto de réplicas do MongoDB definida com SSL e autenticação, como é utilizado para MongoDB Atlas:
$client = new MongoDB\Client( 'mongodb://myUsername:myPassword@rs1.example.com,rs2.example.com/?ssl=true&replicaSet=myReplicaSet&authSource=admin' );
Alternativamente, as credenciais de autenticação e os parâmetros URI podem ser especificados no parâmetro $uriOptions
do construtor:
$client = new MongoDB\Client( 'mongodb://rs1.example.com,rs2.example.com/' [ 'username' => 'myUsername', 'password' => 'myPassword', 'ssl' => true, 'replicaSet' => 'myReplicaSet', 'authSource' => 'admin', ], );
O driver permite opções SSL adicionais, que podem ser especificadas no parâmetro $driverOptions
do construtor. Essas opções são abordadas na documentação do MongoDB\Driver\Manager::__construct().
Especificando opções de conexão
As opções de conexão podem ser passadas através do parâmetro $uri
ou através dos parâmetros $options
e $driverOptions
. As opções disponíveis são documentadas na referência do MongoDB\Client::__construct()
.