(PECL mongo >=0.9.0)
MongoCollection::remove — Eliminar registros de esta colección
$criteria = array()
[, array $options = array()
]] )
criteria
Descripción de los registros que se eliminarán.
options
Opciones de eliminación.
"w"
Véase WriteConcerns. El valor predeterminado de MongoClient es 1.
"justOne"
Eliminar solamente uno de los registros que cumplan las condiciones.
"fsync"
Booleano, su valor predeterminado es FALSE. Si la opción "journal" está habilitada, funciona exactamente como "j". Si no está habilitada, fuerza a la inserción que sea sincronizada con el disco antes de devolver que tuvo éxito. Si es TRUE, está implicada una inserción reconocida y sobrescribirá el ajuste w a 0.
Nota:
Esta opción está obsoleta. Use la opción "j" en su lugar.
"j"
Booleano, su valor predeterminado es FALSE. Fuerza a la inserción a ser sincronizada con el diario antes de devolver que ha tenido éxito. Si es TRUE, implica una inserción reconocida y sobrescribirá el ajuste w a 0.
"w"
Véase WriteConcerns. El valor predeterminado de MongoClient es 1.
"wtimeout"
Cuánto esperar para el reconocimiento de WriteConcern. El valor predeterminado de MongoClient es 10000 milisegundos.
"safe"
Obsoleto. Use la opción w de WriteConcern.
"timeout"
Entero, valor predeterminado MongoCursor::$timeout. Si se usan las escrituras reconocidas, esto estable cuánto debe esperar el cliente (en milisegundos) a una respuesta de la base de datos. Si la base de datos no responde dentro de perído de espera, se lanzará una MongoCursorTimeoutException.
Devuelve un array que contiene el estado de la eliminación si está
establecida la opción "w". De lo contrario, devuelve TRUE.
Los campos del array de estado están descritros en la documentación de MongoCollection::insert().
Lanza una MongoCursorException si la opción "w" está establecida y la escritura falla.
Lanza una MongoCursorTimeoutException si la opción "w" está establecida a un valor mayor que uno y la operación toma más de MongoCursor::$timeout milisegundos en completarse. Esto no pondrá fin a la operación en el servidor, es un tiempo de espera del lado del cliente. La operación en MongoCollection::$wtimeout es milisegundos.
| Versión | Descripción |
|---|---|
| 1.3.0 |
El parámetro options ya no solo acepta un booleano
que indique "soloUno" "justOne". En su lugar, ahora se debe hacer
con array('justOne' => true).
|
| 1.2.11 |
Emite un error de nivel E_DEPRECATED cuando
options es de tipo scalar.
|
| 1.2.0 | Se añadió la opción "timeout". |
| 1.0.11 | Se desconcecta cuando ocurren errores "not master" si "safe" está establecido. |
| 1.0.9 |
Se añadió la capacidad de pasar números enteros a la opción "safe", la cual anteriomente sólo aceptaba valores booleanos. Se añadío la opción "fsync". Es tipo devuelto se cambio para que fuera un array que contuviera la información del error si se usaba la opción "safe". De otro modo, se devolvía un valor booleano como antes. |
| 1.0.5 | Cambiado el segundo parámetro a un array de opciones. Antes de 1.0.5, el segundo parámetro era un booleano indicando la opción "safe". |
Ejemplo #1 Ejemplo de MongoCollection::remove() con justOne
<?php
$radioactivo = $db->radioactivo;
// contar cuánto plution queda
$restante = $radioactivo->count(array('type' => 94));
$vidamedia = $restante/2;
// eliminar la mitad
while ($vidamedia > 0) {
$radioactivo->remove(array('type' => 94), array("justOne" => true));
$vidamedia--;
}
?>