La classe MongoClient

(PECL mongo >=1.3.0)

Avertissement

Cette extension, qui définie cette classe est obsolète. Veuillez utiliser l'extension MongoDB à la place. Les alertnatives à cette classe sont :

Introduction

Un gestionnaire de connexion pour PHP et MongoDB.

Cette classe est utilisée pour créer et gérer les connexions. Voici une utilisation typique :

Exemple #1 Utilisation basique de MongoClient

<?php

$m = new MongoClient(); // connexion
$db = $m->foo; // récupération de la base de données nommée "foo"

?>

Voir MongoClient::__construct() ainsi que la section sur les connexions pour plus d'informations sur la création de connexion.

Synopsis de la classe

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

Constantes pré-définies

MongoClient Constants

MongoClient::VERSION
Version du driver PHP. Peut être suffixée avec "dev", "+" ou "-" s'il s'agit d'une version intermédiaire.
MongoClient::DEFAULT_HOST
Hôte de connexion si aucun hôte n'est fourni.
MongoClient::DEFAULT_PORT
Port de connexion si aucun port n'est fourni.
MongoClient::RP_PRIMARY
Les préférences de lecture pour le membre du jeu de réplication primaire.
MongoClient::RP_PRIMARY_PREFERRED
Les préférences de lecture pour choisir le membre préféré du jeu de réplication primaire.
MongoClient::RP_SECONDARY
Les préférences de lecture pour un membre du jeu de réplication secondaire.
MongoClient::RP_SECONDARY_PREFERRED
Les préférences de lecture pour choisir le membre préféré du jeu de réplication secondaire.
MongoClient::RP_NEAREST
Les préférences de lecture pour le membre le plus proche du jeu de réplication.

Champs

connected

Cette propriété devrait être définie à TRUE si nous avons une connexion ouverte sur la base de données,FALSE sinon. Si la connexion est un jeu de réplication, cette propriété ne pourra valoir que TRUE si le driver a une connexion à noeud correspondant à la préférence de lecture courante. Cette propriété ne prend pas en compte l'identification.

Cette propriété est obsolète depuis la version 1.5.0.

status

Cette propriété n'est plus utilisée et devrait être définie à NULL. Dans les versions 1.1.x et précédentes du driver, cette propriété devait être définie en tant que chaîne de caractères (i.e. "recycled", "new") lorsque les connexions persistentes étaient utilisées.

Cette propriété est obsolète depuis la version 1.5.0.

Voir aussi

Sommaire