MongoClient::__construct

(PECL mongoclient >=0.9.0)

MongoClient::__construct — Crée un nouvel objet de connexion à une base de données

Description

public MongoClient::__construct() ([ string $server = "mongodb://localhost:27017" [, array $options = array("connect" => TRUE) ]] )

Si aucun paramètre n'est passé, la connexion se fera sur "localhost:27017" (ou ce qui a été spécifié dans php.ini pour mongo.default_host et mongo.default_port).

server doit être de la forme :

<?php

// Passer une liste séparée par une virgule de noms de serveurs au constructeur.
// Notez que vous n'avez pas besoin de passer tous les membres du jeu de réplication,
// le driver va dériver la liste complète.
$m1 = new MongoClient("mongodb://sf2.example.com,ny1.example.com", array("replicaSet" => "myReplSet"));

?>

<?php

// Serveur MongoDB local sur le port 20000
$m = new MongoClient("mongodb:///tmp/mongodb-20000.sock");

?>

<?php

// Essaye la connexion socket UNIX, utilise localhost sinon
$m = new MongoClient("mongodb:///tmp/mongodb-27017.sock,localhost:27017");

?>

Exemple #3 Exemple d'authentification MongoClient::__construct()

<?php

$m = new MongoClient("mongodb://testUser:testPass@localhost");

?>

Exemple #4 Exemple avec MongoClient::__construct() et des préférences de lecture

<?php

// Préfère le serveur le plus proche dans le centre de données "east"
$uri  = 'mongodb://rs1.example.com,rs2.example.com/';
$uri .= '?readPreference=nearest';
$uri .= '&readPreferenceTags=dc:east';
$m = new MongoClient($uri, array('replicaSet' => 'rs'));
?>

<?php

// Préfère le serveur le plus proche dans le centre de données "east"
$uri  = 'mongodb://rs1.example.com,rs2.example.com/';
$uri .= '?readPreference=nearest';
$uri .= '&readPreferenceTags=dc:east';
$m = new MongoClient($uri, array('replicaSet' => 'rs'));
?>

Voir la section sur les préférences de lecture de ce manuel pour plus d'informations.

Historique

Version	Description
1.4.0	Ajout de l'option "wTimeoutMS" en tant que remplacement de l'option "wTimeout".
1.3.4	Ajout des options "connectTimeoutMS" et "socketTimeoutMS".
1.3.0	Ajout des options "readPreference", "readPreferenceTags", "w" et "wTimeout".
1.2.0	Ajout des options "username" et "password". Suppression de l'option "persist", toutes les connexions sont désormais persistantes. Le paramètre peut tout de même être utilisé, il sera simplement ignoré. `"persist"` Si la connexion doit être persistante. La chaine représentant la valeur est utilisée comme identifiant de connexion, ainsi deux instances de MongoClient qui sont initialisées avec array("persist" => "foobar") vont partager la même connexion à la base, alors que une instance initialisée avec array("persist" => "barbaz") utilisera une connexion différente. Le paramètre "replicaSet" accepte maintenant une chaine, pas un booléen.
1.0.9	Ajout de l'option "replicaSet".
1.0.2	Le constructeur a changé pour accepter une tableau. Avant 1.0.2, le constructeur acceptait les paramètres suivants : `server` Nom du serveur. `connect` Paramètre optionnel indiquant si le constructeur doit se connecter à la base avant de retourner l'objet. Par défaut `TRUE`. `persistent` Si la connexion doit être persistante. `paired` Si la connexion doit être pairée.