PHP 7.4.0RC2 Released!

La clase MongoDB

(PECL mongo >=0.9.0)

Introducción

Las instancias de esta clase se utilizan para interactuar con la base de datos. Para seleccionar una base de datos:

Ejemplo #1 Seleccionar una base de datos

<?php

$m 
= new MongoClient(); // conectar
$db $m->selectDB("ejemplo");

?>
Los nombres de bases de datos pueden utilizar prácticamente cualquier carácter del rango ASCII. Sin embargo no pueden contener ni " ", "." ni un texto vacío. El nombre "system" también está reservado.

Hay algunos nombres poco usuales de bases de datos que sí son válidos: "null", "[x,y]", "3", "\"", "/".

A diferencia de los nombres de colecciones, los nombres bases de datos pueden contener "$".

Sinopsis de la Clase

MongoDB {
/* Constantes */
const int PROFILING_OFF = 0 ;
const int PROFILING_SLOW = 1 ;
const int PROFILING_ON = 2 ;
/* Campos */
public integer $w = 1 ;
public integer $wtimeout = 10000 ;
/* Métodos */
public authenticate ( string $username , string $password ) : array
public command ( array $command [, array $options = array() [, string &$hash ]] ) : array
public __construct ( MongoClient $conn , string $name )
public createCollection ( string $name [, array $options ] ) : MongoCollection
public createDBRef ( string $collection , mixed $document_or_id ) : array
public drop ( void ) : array
public dropCollection ( mixed $coll ) : array
public execute ( mixed $code [, array $args = array() ] ) : array
public forceError ( void ) : bool
public __get ( string $name ) : MongoCollection
public getCollectionInfo ([ array $options = array() ] ) : array
public getCollectionNames ([ array $options = array() ] ) : array
public getDBRef ( array $ref ) : array
public getGridFS ([ string $prefix = "fs" ] ) : MongoGridFS
public getProfilingLevel ( void ) : int
public getReadPreference ( void ) : array
public getSlaveOkay ( void ) : bool
public getWriteConcern ( void ) : array
public lastError ( void ) : array
public listCollections ([ array $options = array() ] ) : array
public prevError ( void ) : array
public repair ([ bool $preserve_cloned_files = FALSE [, bool $backup_original_files = FALSE ]] ) : array
public resetError ( void ) : array
public selectCollection ( string $name ) : MongoCollection
public setProfilingLevel ( int $level ) : int
public setReadPreference ( string $read_preference [, array $tags ] ) : bool
public setSlaveOkay ([ bool $ok = true ] ) : bool
public setWriteConcern ( mixed $w [, int $wtimeout ] ) : bool
public __toString ( void ) : string
}

Constantes predefinidas

Niveles de Logs de MongoDB

MongoDB::PROFILING_OFF
0
Profiling deshabilitado.
MongoDB::PROFILING_SLOW
1
Profiling habilitado para operaciones lentas (>100 ms).
MongoDB::PROFILING_ON
2
Profiling habilitado para todas las operaciones.

Campos

w
1

Número de servidores en los que replicar los cambios antes de retornar éxito. Se hereda por las instancias de MongoCollection que deriven de este objeto. w sólo está disponible en versiones 1.5.1+ del servidor MongoDB y 1.0.8+ del driver.

w se usa cada vez que sea necesario ajustar el nivel de aceptación (MongoCollection::insert(), MongoCollection::update(), MongoCollection::remove(), MongoCollection::save(), y MongoCollection::ensureIndex() soportan esta opción). Con el valor predeterminado (1), una operación aceptada devolverá una vez que el servidor de bases de datos obtenga la operación. Si el servidor se cayera antes de que la operación fuera replicada a un secundario, podría perderse la operación de forma permanente. De esta forma, se puede especificar en w un valor superior a uno para garantizar que al menos un secundario ha recibido la operación antes de que se considere que ha habido éxito.

Por ejemplo, si w fuera 2, el primario y un secundario tendrán un registro de la operación o el controlador lanzará una MongoCursorException. Puede ser tentador establecer en w el total de secundarios + primario, pero entonces, si un secundario se cayera, la operación fallaría y se lanzaría una excepción, por lo que suele ser más seguro establecer w=2 (primario y un secundario).

wtimeout
10000

Número de milisegundos a esperar a que las réplicas de MongoDB::$w tengan lugar. Se hereda por las instancias de MongoCollection que deriven de este objeto. w sólo está disponible en las versiones 1.5.1+ del servidor MongoDB y en las 1.0.8+ del driver.

A no ser que se establezca un valor en wtimeout, el servidor esperará eternamente a que se replique a w servidores para finalizar. Por omisión el driver esperará 10 segundos. Puede modificarse este valor para alterar este comportamiento.

Ver también

Documentación de MongoDB de » bases de datos.

Tabla de contenidos

add a note add a note

User Contributed Notes 3 notes

up
6
jeromakay at yahoo dot com
8 years ago
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
up
-1
careddumattia at gmail dot com
3 years ago
mongo extension is deprecated.

pecl install mongodb
up
-44
m dot espositoii at yahoo dot com
8 years ago
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.
To Top