Documentation

UpdateMany
in package
implements Executable, Explainable

Operation for updating multiple documents with the update command.

Tags
see
Collection::updateMany()
see
http://docs.mongodb.org/manual/reference/command/update/

Interfaces, Classes, Traits and Enums

Executable
Explainable

Table of Contents

$update  : Update
__construct()  : mixed
Constructs an update command.
execute()  : UpdateResult
Execute the operation.
getCommandDocument()  : array<string|int, mixed>
Returns the command document for this operation.

Properties

Methods

__construct()

Constructs an update command.

public __construct(string $databaseName, string $collectionName, array<string|int, mixed>|object $filter, array<string|int, mixed>|object $update[, array<string|int, mixed> $options = [] ]) : mixed

Supported options:

  • arrayFilters (document array): A set of filters specifying to which array elements an update should apply.

  • bypassDocumentValidation (boolean): If true, allows the write to circumvent document level validation.

  • collation (document): Collation specification.

  • hint (string|document): The index to use. Specify either the index name as a string or the index key pattern as a document. If specified, then the query system will only consider plans using the hinted index.

    This is not supported for server versions < 4.2 and will result in an exception at execution time if used.

  • session (MongoDB\Driver\Session): Client session.

  • upsert (boolean): When true, a new document is created if no document matches the query. The default is false.

  • writeConcern (MongoDB\Driver\WriteConcern): Write concern.

Parameters
$databaseName : string

Database name

$collectionName : string

Collection name

$filter : array<string|int, mixed>|object

Query by which to filter documents

$update : array<string|int, mixed>|object

Update to apply to the matched documents

$options : array<string|int, mixed> = []

Command options

Tags
throws
InvalidArgumentException

for parameter/option parsing errors

Return values
mixed

execute()

Execute the operation.

public execute(Server $server) : UpdateResult
Parameters
$server : Server
Tags
see
Executable::execute()
throws
UnsupportedException

if collation is used and unsupported

throws
RuntimeException

for other driver errors (e.g. connection errors)

Return values
UpdateResult

getCommandDocument()

Returns the command document for this operation.

public getCommandDocument(Server $server) : array<string|int, mixed>
Parameters
$server : Server
Tags
see
Explainable::getCommandDocument()
Return values
array<string|int, mixed>

Search results