MongoClient 类

(PECL mongo >=1.3.0)

简介

PHP 和 MongoDB 的连接管理器。

这个类用于创建和管理连接。典型的用法:

Example #1 MongoClient 基本用法

<?php

$m 
= new MongoClient(); // 连接
$db $m->foo// 获取名称为 "foo" 的数据库

?>

关于创建连接的更多信息,参见 MongoClient::__construct()connecting 的章节。

类摘要

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" ;
/* 属性 */
public boolean $connected = FALSE ;
public string $status = NULL ;
protected string $server = NULL ;
protected boolean $persistent = NULL ;
/* 方法 */
public __construct ([ string $server = "mongodb://localhost:27017" [, array $options = array("connect" => TRUE) ]] )
public bool close ([ boolean|string $connection ] )
public bool connect ( void )
public array dropDB ( mixed $db )
public MongoDB __get ( string $dbname )
public static array getConnections ( void )
public array getHosts ( void )
public array getReadPreference ( void )
public array getWriteConcern ( void )
public bool killCursor ( string $server_hash , int|MongoInt64 $id )
public array listDBs ( void )
public MongoCollection selectCollection ( string $db , string $collection )
public MongoDB selectDB ( string $name )
public bool setReadPreference ( string $read_preference [, array $tags ] )
public bool setWriteConcern ( mixed $w [, int $wtimeout ] )
public string __toString ( void )
}

预定义常量

MongoClient 常量

MongoClient::VERSION
PHP 驱动版本。有可能附加 "dev","+" 或 "-" 如果是在两个版本之间。
MongoClient::DEFAULT_HOST
"localhost"
如果没有指定主机,默认连接该主机。
MongoClient::DEFAULT_PORT
27017
如果没有指定端口,默认连接该端口。
MongoClient::RP_PRIMARY
"primary"
副本集活跃节点的读取选项
MongoClient::RP_PRIMARY_PREFERRED
"primaryPreferred"
副本集活跃节点的读取选项
MongoClient::RP_SECONDARY
"secondary"
副本集备份节点的读取选项
MongoClient::RP_SECONDARY_PREFERRED
"secondaryPreferred"
副本集备份节点的读取选项
MongoClient::RP_NEAREST
"nearest"
副本集最近节点的读取选项

字段属性

connected
如果我们有一个打开的、基于读取选项和标记集(对于集群连接)的数据库连接,将会被设置为 TRUE,否则是 FALSE。 这个属性不考虑账户是否已认证。
status
这个属性不会再被使用,将会被设置为 NULL 在驱动版本 1.1.x 及更早版本中,使用持久连接时这可能会被设置为字符串的值(比如 "recycled""new")。

参见

Table of Contents