Класс MongoClient | Руководство по PHP

(PECL mongo >=1.3.0)

Введение

Менеджер подключения между PHP и MongoDB.

Данный класс служит для создания и управления подключениями. Типичное использование:

Пример #1 Типичное использование MongoClient


<?php

$m = new MongoClient(); // соединение
$db = $m->foo; // получаем базу данных "foo"

?>

Смотрите MongoClient::__construct() и раздел по созданию подключений для более подробной информации по подключению к Mongo.

Обзор классов

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 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": Адрес сервера Mongo, к которому будет происходить подключение, если адрес не указан.
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. Если соединение происходит к набору реплик, то это свойство может быть равным TRUE в случае, если есть соединение к узлу, соответствующему текущей настройке на чтение. Этот параметр не учитывает аутентификацию.

Это свойство устарело с версии 1.5.0.

status

Это свойство больше не используется и должно быть установлено в NULL. В драйвере версии 1.1.x и ранее, это свойство можно задать строками (т.е. "recycled", "new"), если используется постоянное соединение.

Это свойство устарело с версии 1.5.0.

Смотрите также

Read Preferences
Write Concerns
Connecting
Основная документация MongoDB о » соединениях

Содержание

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

Вернуться к: Базовые классы