MongoClient 类

(PECL mongoclient >=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 void getConnections ( void )

public array getHosts ( void )

public array getReadPreference ( void )

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 string __toString ( void )

}

预定义常量

MongoClient 常量

MongoClient::VERSION: PHP 驱动版本。有可能附加 "+" 或 "-" 如果是在两个版本之间。
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。

参见

Read Preferences
Write Concerns
Connecting
关于 » connecting 的 MongoDB 核心文档

MongoClient::close — 关闭连接
MongoClient::connect — 连接到数据库服务器
MongoClient::__construct — 创建一个新的数据库连接对象
MongoClient::dropDB — 删除一个数据库 [已废弃]
MongoClient::__get — 取得一个数据库
MongoClient::getConnections — 返回所有已打开连接的信息
MongoClient::getHosts — 更新所有关联主机的状态信息
MongoClient::getReadPreference — 获取此连接的读取首选项
MongoClient::listDBs — 列出所有有效数据库
MongoClient::selectCollection — 获取数据库的文档集
MongoClient::selectDB — 获取一个数据库
MongoClient::setReadPreference — 为该连接设置读取选项
MongoClient::__toString — 该连接的字符串表达方式

MongoClient 类

简介

类摘要

预定义常量

MongoClient 常量

字段属性

参见

Table of Contents