[edit] Last updated: Fri, 10 Feb 2012

La classe MongoDB

(No version information available, might only be in SVN)

Introduction

Les objets de cette classe servent à interagir avec la base de données. Pour obtenir une base de données :


<?php

$m = new Mongo(); // connexion
$db = $m->selectDB("exemple");

?>

Les noms de base de données peuvent contenir n'importe quel caractère ASCII. Mais ils ne peuvent pas contenir les caractères " ", "." ou être la chaîne vide. Le mot "system" est aussi réservé.

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

MongoDB {

/* Constantes */

const int PROFILING_OFF = 0 ;

const int PROFILING_SLOW = 1 ;

const int PROFILING_ON = 2 ;

/* Champs */

public integer $MongoDB->w = 1 ;

public integer $wtimeout = 10000 ;

/* Méthodes */

public array MongoDB::authenticate ( string $username , string $password )

public array MongoDB::command ( array $command [, array $options = array() ] )

public MongoDB::__construct ( Mongo $conn , string $name )

public MongoCollection MongoDB::createCollection ( string $name [, bool $capped = FALSE [, int $size = 0 [, int $max = 0 ]]] )

public array MongoDB::createDBRef ( string $collection , mixed $a )

public array MongoDB::drop ( void )

public array MongoDB::dropCollection ( mixed $coll )

public array MongoDB::execute ( mixed $code [, array $args = array() ] )

public bool MongoDB::forceError ( void )

public MongoCollection MongoDB::__get ( string $name )

public array MongoDB::getDBRef ( array $ref )

public MongoGridFS MongoDB::getGridFS ([ string $prefix = "fs" ] )

public int MongoDB::getProfilingLevel ( void )

public bool MongoDB::getSlaveOkay ( void )

public array MongoDB::lastError ( void )

public array MongoDB::listCollections ( void )

public array MongoDB::prevError ( void )

public array MongoDB::repair ([ bool $preserve_cloned_files = FALSE [, bool $backup_original_files = FALSE ]] )

public array MongoDB::resetError ( void )

public MongoCollection MongoDB::selectCollection ( string $name )

public int MongoDB::setProfilingLevel ( int $level )

public bool MongoDB::setSlaveOkay ([ bool $ok = true ] )

public string MongoDB::__toString ( void )

}

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 éxecutez une opération "sécurisée" (MongoCollection::insert(), MongoCollection::update(), MongoCollection::remove(), MongoCollection::save(), et MongoCollection::ensureIndex() supportent tous les options sécurisées). Avec la valeur par défaut (1), une opération sécurisée 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 esclave, 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 esclave 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 esclaves 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 esclaves tombe l'opération échouera et une exception sera levée, ainsi w=2 est le cas le plus sécurisant (maitre +1esclave).

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::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::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 — Liste les collections de la 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::setSlaveOkay — Modifie la configuration de slaveOkay pour cette base de données
MongoDB::__toString — Le nom de cette base de données Mongo

MongoDB::authenticate

Mongo::__toString

[edit] Last updated: Fri, 10 Feb 2012

add a note User Contributed Notes MongoDB

m dot espositoii at yahoo dot com 27-Aug-2011 03:11


With Mongo it'll automatically create the collection, so just start using it and it'll do the creation itself.



In other words... just use SelectCollection, if it doesn't exist, it will after that so you can drop it.

jeromakay at yahoo dot com 20-Jan-2011 12:19


based on what I've read and then applied, you don't have to specifically create a database or table, you just initialize it. 



Indeed, files are not being written inside /data/db, but they will the first moment you start adding data.



So, I'm taking as an example Twitter, with no db defined, I'm still going to have the db available if I run this code:



<?php



define('TWITTER_API_VERSION', 1);



date_default_timezone_set("Europe/Dublin");



try 

{

    $m = new Mongo(); // connect

    $db = $m->selectDB("example");

}

catch ( MongoConnectionException $e ) 

{

    echo '<p>Couldn\'t connect to mongodb, is the "mongo" process running?</p>';

    exit();

}



$updates = file_get_contents( "http://api.twitter.com/". TWITTER_API_VERSION ."/statuses/public_timeline.json" );

$updates = json_decode( $updates );



if ( $updates && is_array( $updates ) && count( $updates ) )

{

    foreach ( $updates as $update )

    {    

        $db->users->insert( $update );

    }

}



?>



Hope this was helpful!



Good luck!

Vladimir Ghetau

jonwage at gmail dot com 01-May-2010 11:56


Just a note that if you use selectDB() and only select it, the database will not be created. In PHPMongoDBAdmin(http://github.com/jwage/php-mongodb-admin) I wanted a way to create a database through a form so I needed to create a dummy collection and drop it in order for the database to be created. MongoDB has a drop() method but no create() method.



<?php

$mongo->selectDB('db')->createCollection('__tmp_collection_');

$mongo->selectDB('db')->dropCollection('__tmp_collection_');

?>



Any better way to do this?

add a note