Submit a Pull Request Report a Bug

    MongoDB\Driver\Manager::__construct

    (mongodb >=1.0.0)

    MongoDB\Driver\Manager::__construct — 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.

    Tip

    On Unix platforms, the MongoDB driver is sensitive to scripts that use the fork() system call without also calling exec(). Users are advised not to re-use MongoDB\Driver\Manager instances in a forked child process.

    인수

    uri

    A » mongodb:// connection 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 %. When connecting via a Unix domain socket, the socket path may contain special characters such as slashes and must be encoded. 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

    driverOptions
    Option Type Description
    allow_invalid_hostname bool

    Disables hostname validation if TRUE. Defaults to FALSE.

    Allowing invalid hostnames may expose the driver to a » man-in-the-middle attack.

    ca_dir string

    Path to a correctly hashed certificate directory. The system certificate store will be used by default.

    Falls back to the deprecated "capath" SSL context option if not specified.

    ca_file string

    Path to a certificate authority file. The system certificate store will be used by default.

    Falls back to the deprecated "cafile" SSL context option if not specified.

    crl_file string Path to a certificate revocation list file.
    pem_file string

    Path to a PEM encoded certificate to use for client authentication.

    Falls back to the deprecated "local_cert" SSL context option if not specified.

    pem_pwd string

    Passphrase for the PEM encoded certificate (if applicable).

    Falls back to the deprecated "passphrase" SSL context option if not specified.

    context resource

    SSL context options to be used as fallbacks for other driver options (as specified). Note that the driver does not consult the default stream context.

    This option is supported for backwards compatibility, but should be considered deprecated.

    weak_cert_validation bool

    Disables certificate validation if TRUE. Defaults to FALSE

    Falls back to the deprecated "allow_self_signed" SSL context option if not specified.

    오류/예외

    변경점

    버전 설명
    1.2.0

    Added the "allow_invalid_hostname", "ca_file", "ca_dir", "clr_file", "pem_file", "pem_pwd", and "weak_cert_validation" driver options.

    The driver no longer supports all SSL context options via the "context" driver option, since the PHP Streams API is no longer used for socket communication.

    예제

    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 standalone MongoDB node via a Unix domain socket. The socket path may include special characters such as slashes and should be encoded with rawurlencode().

    <?php

    $manager     = new MongoDB\Driver\Manager("mongodb://" . rawurlencode("/tmp/mongodb-27017.sock"));

    ?>

    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/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, the password string myp@ss:w%rd has been manually escaped; however, rawurlencode() may also be used to escape URI components that may contain special characters.

    <?php

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

    ?>

    Connecting to MongoDB with X509 authentication:

    <?php

    $manager     = new MongoDB\Driver\Manager(
            "mongodb://example.com/?ssl=true&authMechanism=MONGODB-X509",
        [],
        [
                "pem_file" => "/path/to/client.pem",
        ]
    );
    ?>
    add a note add a note

    User Contributed Notes 2 notes

    up
    -1
    denys at bulakhweb dot com
    6 years ago
    Please note, if you send socketTimeoutMs value as 0 to disable timeout (according to MongoDB documentation), it will be considered as default value which is 300,000 ms in PHP driver. So send some really huge amount in case if you need to disable limitation.
    up
    -2
    denys at bulakhweb dot com
    6 years ago
    Please note, if you send socketTimeoutMs value as 0 to disable timeout (according to MongoDB documentation), it will be considered as default value which is 300,000 ms in PHP driver. So send some really huge amount in case if you need to disable limitation.
    add a note add a note
    To Top