(mongodb >=2.1.0)
MongoDB\Driver\BulkWriteCommand::replaceOne — Adiciona uma operação replaceOne
$namespace,$filter,$replacement,$options = null
Adiciona uma operação replaceOne ao
MongoDB\Driver\BulkWriteCommand. O primeiro documento
correspondente a filter na coleção identificada por
namespace será substituído.
namespace (string)
Um namespace totalmente qualificado (por exemplo, "nomeDoBancoDados.nomeDaColecao").
filter (array|object)O » predicado de consulta. Um predicado vazio corresponderá a todos os documentos da coleção.
Nota: Ao avaliar os critérios de consulta, o MongoDB compara os tipos e valores de acordo com suas próprias » regras de comparação para tipos BSON, que diferem das regras de comparação e do malabarismo de tipos do PHP. Ao corresponder a um tipo especial de BSON, os critérios de consulta devem usar a respectiva classe BSON (por exemplo, use MongoDB\BSON\ObjectId para corresponder a um » ObjectId).
replacement (array|object)Um documento de substituição.
options
| Opção | Tipo | Descrição | Padrão |
|---|---|---|---|
| collation | array|object |
» Collation permite que os usuários especifiquem regras específicas do idioma para comparação de strings, como regras para maiúsculas e minúsculas e acentos. Ao especificar a collation, o campo Se a collation não for especificada, mas a coleção tiver uma collation padrão, a operação usará a collation especificada para a coleção. Se nenhuma collation for especificada para a coleção ou para a operação, o MongoDB usará a comparação binária simples usada em versões anteriores para comparações de strings. Esta opção está disponível no MongoDB 3.4+ e resultará em uma exceção em tempo de execução se for especificada para uma versão de servidor mais antiga. |
|
| hint | string|array|object |
Especificação de índice. Especifique o nome do índice como uma string ou o padrão de chave do índice. Se especificado, o sistema de consulta considerará apenas planos que utilizem o índice sugerido. |
|
| sort | array|object |
Especifica qual documento a operação substitui se a consulta corresponder a vários documentos. O primeiro documento correspondido pela ordem de classificação será substituído. |
|
| upsert | bool |
Se filter não corresponder a um documento existente,
insira um único documento. O documento será
criado a partir de replacement.
|
false |
Nenhum valor é retornado.
Exemplo #1 Exemplo 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);
?>