array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'mongodb-driver-bulkwritecommand.replaceone.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand::replaceOne', 2 => 'Añade una operación replaceOne', ), 'up' => array ( 0 => 'class.mongodb-driver-bulkwritecommand.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand', ), 'prev' => array ( 0 => 'mongodb-driver-bulkwritecommand.insertone.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand::insertOne', ), 'next' => array ( 0 => 'mongodb-driver-bulkwritecommand.updatemany.php', 1 => 'MongoDB\\Driver\\BulkWriteCommand::updateMany', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/mongodb/mongodb/driver/bulkwritecommand/replaceone.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

MongoDB\Driver\BulkWriteCommand::replaceOne

(mongodb >=2.1.0)

MongoDB\Driver\BulkWriteCommand::replaceOne — Añade una operación replaceOne

Descripción

public MongoDB\Driver\BulkWriteCommand::replaceOne(
    string $namespace,
    array|object $filter,
    array|object $replacement,
    ?array $options = null
): void

Añade una operación replaceOne a la MongoDB\Driver\BulkWriteCommand. El primer documento que coincida con filter en la colección identificada por namespace será reemplazado.

Parámetros

namespace (string)

Un espacio de nombres completamente calificado (ej. "databaseName.collectionName")

filter (array|object)

El » atributo de la consulta. Un atributo vacío hará coincidir todos los documentos de la colección.

Nota: Al evaluar los criterios de consulta, MongoDB compara los tipos y los valores según sus propias » reglas de comparación para los tipos BSON, que difieren de las reglas de comparación y de manipulación de tipos de PHP. Al hacer coincidir un tipo BSON especial, los criterios de consulta deben utilizar la clase BSON (ej.: utilizar MongoDB\BSON\ObjectId para hacer coincidir un » ObjectId).

replacement (array|object)

Un documento de reemplazo.

options

options
Opción Tipo Descripción Valor por omisión
collation array|object

» Collation permite a los usuarios especificar reglas específicas del lenguaje para la comparación de cadenas, por ejemplo, reglas para mayúsculas o acentos. Al especificar una collation, el campo "locale" es obligatorio; todos los demás campos de la collation son opcionales. Para la descripción de estos campos, consúltese el » documento Collation.

Si la collation no es especificada pero la colección tiene una collation por omisión, la operación utilizará la collation especificada para la colección. Si ninguna collation es especificada para la colección o para la operación, MongoDB utilizará el binario simple de comparación utilizado en versiones anteriores para las comparaciones de cadenas.

Esta opción está disponible en MongoDB 3.4+ y una excepción será emitida en tiempo de ejecución si es especificada en una versión anterior.

hint string|array|object

Especificación del índice. Especifique el nombre del índice como string o el modelo de clave del índice. Si se especifica, el sistema de consulta no considerará planes que no utilicen el índice sugerido.

sort array|object

Especifica qué documento reemplazará la operación si la consulta coincide con múltiples documentos. El primer documento que coincida con el orden de clasificación será reemplazado.

upsert bool Si filter no coincide con ningún documento, inserta un documento single. El documento será creado desde replacement. false

Valores devueltos

No se retorna ningún valor.

Errores/Excepciones

Ejemplos

Ejemplo #1 Ejemplo de MongoDB\Driver\BulkWriteCommand::replaceOne()

<?php

$manager = new MongoDB\Driver\Manager;

$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->replaceOne('db.coll', ['x' => 1], ['x' => 1, 'y' => 2]);

$result = $manager->executeBulkWriteCommand($bulk);

?>

Ver también