Clases del núcleo
PHP Manual

Clase MongoDB

(No hay información de versión disponible, podría estar únicamente en SVN)

Introducción

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

<?php

$m 
= new Mongo(); // 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 array authenticate ( string $username , string $password )
public array command ( array $command [, array $options = array() ] )
public __construct ( Mongo $conn , string $name )
public MongoCollection createCollection ( string $name [, bool $capped = FALSE [, int $size = 0 [, int $max = 0 ]]] )
public array createDBRef ( string $collection , mixed $a )
public array drop ( void )
public array dropCollection ( mixed $coll )
public array execute ( mixed $code [, array $args = array() ] )
public bool forceError ( void )
public MongoCollection __get ( string $name )
public array getDBRef ( array $ref )
public MongoGridFS getGridFS ([ string $prefix = "fs" ] )
public int getProfilingLevel ( void )
public bool getSlaveOkay ( void )
public array lastError ( void )
public array listCollections ( void )
public array prevError ( void )
public array repair ([ bool $preserve_cloned_files = FALSE [, bool $backup_original_files = FALSE ]] )
public array resetError ( void )
public MongoCollection selectCollection ( string $name )
public int setProfilingLevel ( int $level )
public bool setSlaveOkay ([ bool $ok = true ] )
public string __toString ( void )
}

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 se realiza una operación "segura" ( MongoCollection::insert(), MongoCollection::update(), MongoCollection::remove(), MongoCollection::save(), y MongoCollection::ensureIndex() soportan la opción segura). Con el valor por omisión (1), una operación segura devolverá el control cuando el servidor de bases de datos obtenga la operación. Si el servidor se cayera antes de que la operación se replicara a un esclavo, podría perderse la operación de forma permanente. De esta forma, se puede especificar en w un valor superior a 1 para garantizar que al menos un esclavo ha recibido la operación antes de que se considere que ha habido éxito.

Por ejemplo, si w fuera 2, tanto el servidor principal como un esclavo tendrán un registro de la operación. Si no, el driver emitirá una excepción MongoCursorException. Puede ser tentador establecer en w el total de esclavos + maestro, pero entonces, si un esclavo se cayera, la operación fallaría y se emitiría una excepción, por lo que suele ser más seguro establecer w=2 (maestro + 1 esclavo).

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


Clases del núcleo
PHP Manual