La classe MongoClient
(PECL mongoclient >=1.3.0)
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 */
/* Propriétés */
protected
string
$server
=
NULL
;
protected
boolean
$persistent
=
NULL
;/* Méthodes */
public __construct
([ string
}$server
= "mongodb://localhost:27017"
[, array $options
= array("connect" => TRUE
)
]] )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
"localhost"
- Hôte de connexion si aucun hôte n'est fourni.
-
MongoClient::DEFAULT_PORT
27017
- Port de connexion si aucun port n'est fourni.
-
MongoClient::RP_PRIMARY
"primary"
- Les préférences de lecture pour le membre du jeu de réplication primaire.
-
MongoClient::RP_PRIMARY_PREFERRED
"primaryPreferred"
- Les préférences de lecture pour choisir le membre préféré du jeu de réplication primaire.
-
MongoClient::RP_SECONDARY
"secondary"
- Les préférences de lecture pour un membre du jeu de réplication secondaire.
-
MongoClient::RP_SECONDARY_PREFERRED
"secondaryPreferred"
- Les préférences de lecture pour choisir le membre préféré du jeu de réplication secondaire.
-
MongoClient::RP_NEAREST
"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, basée sur les préférences de lecture ainsi que sur le jeu de tags (pour les connexions ReplicaSet),FALSE
sinon. Cette propriété ne prend pas en compte l'authentification. - 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.
Voir aussi
- Préférences de lecture
- Write Concerns
- Connection
- La documentation sur le coeur MongoDB, à propos des » connexions
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::killCursor — Kills a specific cursor on the server
- 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::__toString — Produit une représentation sous forme de chaîne de la connexion