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 :

MongoDB\Driver\Manager

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.

Retour à la première page de Manuel PHP Table des matières Haut

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

}

Retour à la première page de Manuel PHP Table des matières Haut

Constantes pré-définies

Retour à la première page de Manuel PHP Table des matières Haut

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.

Retour à la première page de Manuel PHP Table des matières Haut

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.

Retour à la première page de Manuel PHP Table des matières Haut

Voir aussi

Préférences de lecture
Write Concerns
Connection
La documentation sur le coeur MongoDB, à propos des » connexions

Retour à la première page de Manuel PHP Table des matières Haut

Sommaire

MongoClient::close — Ferme la connexion
MongoClient::connect — Ouvre une connexion au serveur de base de données
MongoClient::__construct — Crée un nouvel objet de connexion à une base de données
MongoClient::dropDB — Supprime une base de données [obsolète]
MongoClient::__get — Récupère une base de données
MongoClient::getConnections — Retourne des informations sur toutes les connexions ouvertes
MongoClient::getHosts — Met à jour les statuts de tous les hôtes associés
MongoClient::getReadPreference — Récupère les préférences de lecture pour cette connexion
MongoClient::getWriteConcern — Récupère la préoccupation d'écriture pour cette connexion
MongoClient::killCursor — Supprime un curseur spécifique du serveur
MongoClient::listDBs — Liste toutes les bases de données disponibles
MongoClient::selectCollection — Lit une collection de base de données
MongoClient::selectDB — Récupère une base de données
MongoClient::setReadPreference — Définit les préférences de lecture pour cette connexion
MongoClient::setWriteConcern — Défini la préoccupation d'écriture pour cette connexion
MongoClient::__toString — Produit une représentation sous forme de chaîne de la connexion

Rechercher une fonction PHP

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-class.mongoclient.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut