Create new MongoDB Manager

说明

final public MongoDB\Driver\Manager::__construct ( string $uri [, array $options [, array $driverOptions ]] )

Constructs a new MongoDB\Driver\Manager object with the specified options.

参数

uri

mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]

The uri is a URL, hence any special characters in its components need to be URL encoded according to » RFC 3986. This is particularly relevant to the username and password, which can often include special characters such as @, :, or %. The rawurlencode() function may be used to encode constituent parts of the URI.

options

» Connection string options.

Note:
Specifying options via the options argument will overwrite any options with the same name in the uri argument.

driverOptions

Any driver-specific options not included in MongoDB connection string specification.

错误／异常

Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.
Throws MongoDB\Driver\Exception\RuntimeException if the uri format is invalid

范例

Example #1 MongoDB\Driver\Manager::__construct() basic examples

Connecting to standalone MongoDB node:


<?php

$manager = new MongoDB\Driver\Manager("mongodb://example.com:27017");

?>

Connecting to a replica set:


<?php

$manager = new MongoDB\Driver\Manager("mongodb://rs1.example.com,rs2.example.com/?replicaSet=myReplicaSet");

?>

Connecting to a sharded cluster (i.e. one or more mongos instances):


<?php

$manager = new MongoDB\Driver\Manager("mongodb://mongos1.example.com,mongos2.example.com/");

?>

Connecting to MongoDB with authentication credentials for a particular user and database:


<?php

$manager = new MongoDB\Driver\Manager("mongodb://myusername:mypassword@example.com:27017/mydatabase");

?>

Connecting to MongoDB with authentication credentials for a particular user and database, where the username or password includes special characters (e.g. @, :, %). In the following example, myp@ss:w%rd is being used as the password:


<?php

$manager = new MongoDB\Driver\Manager("mongodb://myusername:myp%40ss%3Aw%25rd@example.com:27017/mydatabase");

?>

Connecting to MongoDB with SSL and a client certificate:


<?php

$manager = new MongoDB\Driver\Manager(
    "mongodb://username:password@example.com:28071/admin?ssl=true",
    [],
    [
        "local_cert" => "/path/to/client.pem",
        "passphrase" => "Very secretive client.pem passphrase",
    ]
);
?>

参见

» MongoDB Connection String Format