MongoClient クラス

(PECL mongo >=1.3.0)

導入

PHP と MongoDB の接続を管理します。

このクラスを使って、接続を作ったり管理したりします。典型的な使いかたは、このようになります。

例1 MongoClient の基本的な使いかた


<?php

$m = new MongoClient(); // 接続します
$db = $m->foo; // "foo" というデータベースを取得します

?>

接続の作成に関する詳細な情報は、 MongoClient::__construct() および接続のセクションを参照ください。

クラス概要

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) [, array $driver_options ]]] )

public bool Mongo::close ([ boolean|string $connection ] )

public bool Mongo::connect ( void )

public array Mongo::dropDB ( mixed $db )

public MongoDB Mongo::__get ( string $dbname )

public static array getConnections ( void )

public array Mongo::getHosts ( void )

public array getReadPreference ( void )

public array getWriteConcern ( void )

public bool killCursor ( string $server_hash , int|MongoInt64 $id )

public array Mongo::listDBs ( void )

public MongoCollection Mongo::selectCollection ( string $db , string $collection )

public MongoDB Mongo::selectDB ( string $name )

public bool setReadPreference ( string $read_preference [, array $tags ] )

public bool setWriteConcern ( mixed $w [, int $wtimeout ] )

public string Mongo::__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 を設定するのは、 ReadPreference およびタグセット (レプリカセット接続の場合) に基づいたデータベース接続がオープンしている場合です。それ以外の場合は FALSE を設定します。このプロパティは、認証を考慮しません。
status: このプロパティはもう使われておらず、値は NULL に設定されます。バージョン 1.1.x より前のドライバでは、持続的接続を使う場合にここに文字列 ("recycled" や "new" など) が設定されていました。

参考

優先読み込み
書き込み確認
接続
MongoDB コアドキュメントの » connecting

Mongo::close — 接続を閉じる
Mongo::connect — データベースサーバーに接続する
Mongo::__construct — 新しいデータベース接続オブジェクトを作成する
Mongo::dropDB — データベースを削除する [非推奨]
Mongo::__get — データベースを取得する
MongoClient::getConnections — 開いているすべての接続の情報を返す
Mongo::getHosts — 関連づけられたすべてのホストの状態を更新する
MongoClient::getReadPreference — この接続の優先読み込みを取得する
MongoClient::getWriteConcern — Get the write concern for this connection
MongoClient::killCursor — サーバー上の指定したカーソルを削除する
Mongo::listDBs — すべてのデータベースの一覧を取得する
Mongo::selectCollection — データベースコレクションを取得する
Mongo::selectDB — データベースを取得する
MongoClient::setReadPreference — この接続の優先読み込みを設定する
MongoClient::setWriteConcern — Set the write concern for this connection
Mongo::__toString — この接続の文字列表現

MongoClient クラス

導入

クラス概要

定義済み定数

MongoClient 定数

フィールド

参考

目次