La classe MongoDB
(PECL mongo >=0.9.0)
Introduction
Les objets de cette classe servent à interagir avec la base de données. Pour obtenir une base de données :
Exemple #1 Sélection d'une base de données
<?php $m = new MongoClient(); // connexion $db = $m->selectDB("exemple"); ?>
Quelques noms de base de données valides mais inattendus : "null", "[x,y]", "3", à"\"", "/".
Contrairement aux noms de collection, les noms de bases de données peuvent contenir "$".
Synopsis de la classe
$preserve_cloned_files
= FALSE
[, bool $backup_original_files
= FALSE
]] )Constantes pré-définies
Niveaux d'historisation de MongoDB
-
MongoDB::PROFILING_OFF
0
- Le profilage est inactif.
-
MongoDB::PROFILING_SLOW
1
- Le profilage est actif pour les opérations lentes (>100 ms).
-
MongoDB::PROFILING_ON
2
- Le profilage est actif sur toutes les opérations.
Champs
-
w
1 -
Le nombre de serveurs vers lesquels répliquer avant de retourner avec succès. Hérité par les instances dérivées de la MongoCollection La fonctionnalité w n'est disponible que pour les versions 1.5.1+ du serveur MongoDB et 1.0.8+ du pilote.
w est utilisé chaque fois que vous avez besoin d'ajuster le niveau de reconnaissance ( MongoCollection::insert(), MongoCollection::update(), MongoCollection::remove(), MongoCollection::save(), et MongoCollection::ensureIndex() supportent tous cette option). Avec la valeur par défaut (1), une opération reconnue retournera une fois que le serveur a effectué l'opération. Si le serveur tombe avant que l'opération ne soit répliquée vers un secondaire, il est possible de perdre l'opération. Ainsi vous pouvez préciser une valeur supérieure à 1 pour le paramètre w et garantir qu'au moins un secondaire recoive l'opération avant qu'elle ne soit considérée comme étant réalisée avec succès.
Par exemple si w vaut 2, le serveur principal et un des secondaires doivent avoir enregistré l'opération ou le pilote enverra une MongoCursorException. Il est tentant de mettre le nombre total d'escalves + le maitre comme numéro pour w, mais alors si un des secondaires tombe l'opération échouera et une exception sera levée, ainsi w=2 est le cas le plus sécurisant (maitre et un secondaire).
-
wtimeout
10000 -
Le nombre de millisecondes à attendre pour que les réplications de MongoDB::$w démarrent. Hérité par les instances dérivées dans la MongoCollection en cours. La fonctionnalité w n'est disponible que depuis la version 1.5.1+ du serveur MongoDB et 1.0.8+ du pilote.
Sauf si wtimeout est précisé, le serveur attendra indéfiniment que la réplication vers les serveurs w se termine. Le pilote attendra par défaut 10 secondes, vous pouvez changer cette valeur.
Voir aussi
Documentation de MongoDB » concernant les bases de données.
Sommaire
- MongoDB::authenticate — Identification à une base de données
- MongoDB::command — Exécute une commande de base de données
- MongoDB::__construct — Crée une nouvelle base de données Mongo
- MongoDB::createCollection — Crée une collection
- MongoDB::createDBRef — Crée une référence de base de données
- MongoDB::drop — Supprime cette base de données
- MongoDB::dropCollection — Supprime une collection [obsolète]
- MongoDB::execute — Exécute le code JavaScript sur la base de données
- MongoDB::forceError — Crée une erreur de base de données
- MongoDB::__get — Récupère une collection
- MongoDB::getCollectionNames — Récupère toutes les collections pour cette base de données
- MongoDB::getDBRef — Lit le contenu d'une référence de base de données
- MongoDB::getGridFS — Manipulations des fichiers dans la base
- MongoDB::getProfilingLevel — Lit le niveau de profilage de la base de données
- MongoDB::getReadPreference — Récupère les préférences de lecture pour cette base de données
- MongoDB::getSlaveOkay — Récupère la configuration de slaveOkay pour cette base de données
- MongoDB::lastError — Vérifie s'il y a une erreur sur la dernière opération relative à la base de données
- MongoDB::listCollections — Récupère un tableau de tous les MongoCollections pour cette base de données
- MongoDB::prevError — Vérifie la dernière erreur émise lors d'une opération relative à la base de données
- MongoDB::repair — Répare et compacte une base de données
- MongoDB::resetError — Efface toutes les erreurs d'une base de données
- MongoDB::selectCollection — Lit une collection
- MongoDB::setProfilingLevel — Configure le niveau de profilage de la base de données
- MongoDB::setReadPreference — Définit les préférences de lecture pour cette base de données
- MongoDB::setSlaveOkay — Modifie la configuration de slaveOkay pour cette base de données
- MongoDB::__toString — Le nom de cette base de données Mongo