(mongodb >=2.1.0)
MongoDB\Driver\BulkWriteCommand::updateOne — Adiciona uma operação updateOne
$namespace,$filter,$update,$options = null
Adiciona uma operação updateOne ao
MongoDB\Driver\BulkWriteCommand. O primeiro documento
correspondente a filter na coleção identificada por
namespace será atualizado.
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).
update (array|object)
Um documento contendo operadores de atualização (por exemplo,
$set) ou um
» pipeline de agregação.
options
| Opção | Tipo | Descrição | Padrão |
|---|---|---|---|
| arrayFilters | array |
Um conjunto de documentos de filtro que determina quais elementos do conjunto devem ser modificados para uma operação de atualização em um campo do conjunto. Consulte » Especificar Filtros de Conjunto para Operações de Atualização de Conjunto no manual do MongoDB para obter mais informações. |
|
| 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 atualiza se a consulta corresponder a vários documentos. O primeiro documento correspondido pela ordem de classificação será atualizado. |
|
| upsert | bool |
Se filter não corresponder a um documento existente,
insira um único documento. O documento será
criado aplicando operadores em update a quaisquer
valores de campo em filter.
|
false |
Nenhum valor é retornado.
Exemplo #1 Exemplo de MongoDB\Driver\BulkWriteCommand::updateOne()
<?php
$manager = new MongoDB\Driver\Manager;
$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->updateOne('db.coll', ['x' => 1], ['$set' => ['y' => 2]]);
$result = $manager->executeBulkWriteCommand($bulk);
?>