Php/docs/class.mongodb
(PECL mongo >=0.9.0)
简介
该类的实例用于和数据库进行交互。要获取一个数据库:
Example #1 选择一个数据库
<?php$m = new MongoClient(); // 连接$db = $m->selectDB("example");?>
数据库名可以用 ASCII 范围内的几乎任何字符。 但是,它们不能包括 " "、".",或者是空字符串。 名称 "system" 也是被保留的。 个别特殊但有效的数据库名:"null"、"[x,y]"、"3"、"\""、 "/"。
不像集合名,数据库名是可以包含 "$" 的。
类摘要
MongoDB {
const
int
PROFILING_OFF
= 0
const
int
PROFILING_SLOW
= 1
const
int
PROFILING_ON
= 2
/* Fields */
public
integer
$w
= 1
public
integer
$wtimeout
= 10000
/* 方法 */
public authenticate
( string $username
, string $password
) : array
public command
( array $command
[, array $options
= array()
] ) : array
public __construct
( MongoClient $conn
, string $name
)
public createCollection
( string $name
[, array $options
] ) : MongoCollection
public createDBRef
( string $collection
, mixed $document_or_id
) : array
public drop ( ) : array
public dropCollection
( mixed $coll
) : array
public forceError ( ) : bool
public __get
( string $name
) : MongoCollection
public getCollectionInfo
([ array $options
= array()
] ) : array
public getCollectionNames
([ array $options
= array()
] ) : array
public getDBRef
( array $ref
) : array
public getGridFS
([ string $prefix
= "fs"
] ) : MongoGridFS
public getProfilingLevel ( ) : int
public getReadPreference ( ) : array
public getSlaveOkay ( ) : bool
public getWriteConcern ( ) : array
public lastError ( ) : array
public listCollections
([ array $options
= array()
] ) : array
public prevError ( ) : array
public repair
([ bool $preserve_cloned_files
= false
[, bool $backup_original_files
= false
]] ) : array
public resetError ( ) : array
public selectCollection
( string $name
) : MongoCollection
public setProfilingLevel
( int $level
) : int
public setReadPreference
( string $read_preference
[, array $tags
] ) : bool
public setSlaveOkay
([ bool $ok
= true
] ) : bool
public setWriteConcern
( mixed $w
[, int $wtimeout
] ) : bool
public __toString ( ) : string
}
预定义常量
MongoDB 日志级别
MongoDB::PROFILING_OFF
0
- 关闭了分析器。
MongoDB::PROFILING_SLOW
1
- 为慢操作开启了分析器(>100 ms)。
MongoDB::PROFILING_ON
2
- 为所有操作开启了分析器。
字段
w
1在返回成功之前,复制修改到此数量的服务器。 MongoCollection 实例的设置从这里继承。
w
仅仅在 MongoDB 服务器版本 1.5.1+ 以及本驱动 1.0.8+ 有效。w
用于你需要调整确认级别时 (MongoCollection::insert()、 MongoCollection::update()、 MongoCollection::remove()、 MongoCollection::save() 和 MongoCollection::ensureIndex() 都支持这个选项)。 默认值(1)情况下,只要数据库有操作就会确认。 如果在复制到从服务器前服务器宕机了,它将可能永久丢失本次操作。 所以,你可以为w
指定一个比一更高的数字, 在返回成功之前确保至少一个从服务器完成了操作。例如,如果
w
是 2,主服务器和一个从服务必须记录了本次操作, 否则驱动会抛出 MongoCursorException。 它尝试写入总计w
个从服务器 + 主服务器,但是如果其中一个从服务器宕机了, 操作也会失败,并会抛出异常,所以通常w=2
是最安全的(主服务器和一个从服务器)。wtimeout
10000等待
MongoDB::$w
复制生效的毫秒数。 MongoCollection 实例的设置从这里继承。w
仅仅在 MongoDB 服务器版本 1.5.1+ 并且驱动版本 1.0.8+ 有效。除非设置了
wtimeout
,服务器会永久等待复制到w
个服务器。 这个驱动默认会等待 10 秒,你可以修改这个值来改变它的行为。
Table of Contents
- MongoDB::authenticate — 登录到数据库
- MongoDB::command — 执行一条 Mongo 指令
- MongoDB::__construct — 选择一个数据库
- MongoDB::createCollection — 创建一个集合
- MongoDB::createDBRef — 创建数据库引用
- MongoDB::drop — 删除数据库
- MongoDB::dropCollection — Drops a collection [deprecated]
- MongoDB::execute — 在数据库服务器上运行JavaScript
- MongoDB::forceError — Creates a database error
- MongoDB::__get — Gets a collection
- MongoDB::getCollectionInfo — Returns information about collections in this database
- MongoDB::getCollectionNames — Gets an array of names for all collections in this database
- MongoDB::getDBRef — Fetches the document pointed to by a database reference
- MongoDB::getGridFS — Fetches toolkit for dealing with files stored in this database
- MongoDB::getProfilingLevel — Gets this database's profiling level
- MongoDB::getReadPreference — Get the read preference for this database
- MongoDB::getSlaveOkay — Get slaveOkay setting for this database
- MongoDB::getWriteConcern — Get the write concern for this database
- MongoDB::lastError — Check if there was an error on the most recent db operation performed
- MongoDB::listCollections — Gets an array of MongoCollection objects for all collections in this database
- MongoDB::prevError — Checks for the last error thrown during a database operation
- MongoDB::repair — Repairs and compacts this database
- MongoDB::resetError — Clears any flagged errors on the database
- MongoDB::selectCollection — Gets a collection
- MongoDB::setProfilingLevel — Sets this database's profiling level
- MongoDB::setReadPreference — Set the read preference for this database
- MongoDB::setSlaveOkay — Change slaveOkay setting for this database
- MongoDB::setWriteConcern — Set the write concern for this database
- MongoDB::__toString — The name of this database
/* 常量 */