Php/docs/class.mongoclient
(PECL mongo >=1.3.0)
Warning This extension that defines this class is deprecated. Instead, the MongoDB extension should be used. Alternatives to this class include:
Introduction
A connection manager for PHP and MongoDB.
This class is used to create and manage connections. A typical use is:
Example #1 MongoClient basic usage
<?php$m = new MongoClient(); // connect$db = $m->foo; // get the database named "foo"?>
See MongoClient::__construct() and the section on connecting for more information about creating connections.
Class synopsis
MongoClient {
const
string
VERSION
const
string
DEFAULT_HOST
= "localhost"
const
int
DEFAULT_PORT
= 27017
const
string
RP_PRIMARY
= "primary"
const
string
RP_PRIMARY_PREFERRED
= "primaryPreferred"
const
string
RP_SECONDARY
= "secondary"
const
string
RP_SECONDARY_PREFERRED
= "secondaryPreferred"
const
string
RP_NEAREST
= "nearest"
/* Properties */
public
bool
$connected
= FALSE
public
string
$status
= NULL
protected
string
$server
= NULL
protected
bool
$persistent
= NULL
/* Methods */
public __construct
([ string $server
= "mongodb://localhost:27017"
[, array $options
= array("connect" => TRUE
)
[, array $driver_options
]]] )
public close
([ bool|string $connection
] ) : bool
public connect ( ) : bool
public static getConnections ( ) : array
public getHosts ( ) : array
public getReadPreference ( ) : array
public getWriteConcern ( ) : array
public killCursor
( string $server_hash
, int|MongoInt64 $id
) : bool
public listDBs ( ) : array
public selectCollection
( string $db
, string $collection
) : MongoCollection
public setReadPreference
( string $read_preference
[, array $tags
] ) : bool
public setWriteConcern
( mixed $w
[, int $wtimeout
] ) : bool
public __toString ( ) : string
}
Predefined Constants
MongoClient Constants
MongoClient::VERSION
- PHP driver version. May be suffixed with "dev", "+" or "-" if it is in-between versions.
MongoClient::DEFAULT_HOST
- Host to connect to if no host is given.
MongoClient::DEFAULT_PORT
- Port to connect to if no port is given.
MongoClient::RP_PRIMARY
- Read preference for the primary replica set member.
MongoClient::RP_PRIMARY_PREFERRED
- Read preference for preferring the primary replica set member.
MongoClient::RP_SECONDARY
- Read preference for a secondary replica set member.
MongoClient::RP_SECONDARY_PREFERRED
- Read preference for preferring a secondary replica set member.
MongoClient::RP_NEAREST
- Read preference for the nearest replica set member.
Fields
connected
This property will be set to
TRUE
if we have a open connection to the database,FALSE
otherwise. If the connection is to a replica set, this property will only beTRUE
if the driver has a connection to a node matching the current read preference. This property does not take authentication into account.This property is deprecated since version 1.5.0.
status
This property is no longer used and will be set to
NULL
In driver versions 1.1.x and earlier, this may be set to a string value (e.g."recycled"
,"new"
) when persistent connections are used.This property is deprecated since version 1.5.0.
Table of Contents
- MongoClient::close — Closes this connection
- MongoClient::connect — Connects to a database server
- MongoClient::__construct — Creates a new database connection object
- MongoClient::dropDB — Drops a database [deprecated]
- MongoClient::__get — Gets a database
- MongoClient::getConnections — Return info about all open connections
- MongoClient::getHosts — Updates status for all associated hosts
- MongoClient::getReadPreference — Get the read preference for this connection
- MongoClient::getWriteConcern — Get the write concern for this connection
- MongoClient::killCursor — Kills a specific cursor on the server
- MongoClient::listDBs — Lists all of the databases available
- MongoClient::selectCollection — Gets a database collection
- MongoClient::selectDB — Gets a database
- MongoClient::setReadPreference — Set the read preference for this connection
- MongoClient::setWriteConcern — Set the write concern for this connection
- MongoClient::__toString — String representation of this connection
/* Constants */