Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.10.x will end 8 November 2021 (12 months).
  • Bug fixes for security issues in 3.10.x will end 9 May 2022 (18 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.

Differences Between: [Versions 310 and 311] [Versions 310 and 400] [Versions 310 and 401]

(no description)

File Size: 165 lines (6 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

FindOneAndUpdate:: (3 methods):
  __construct()
  execute()
  getCommandDocument()


Class: FindOneAndUpdate  - X-Ref

Operation for updating a document with the findAndModify command.

__construct($databaseName, $collectionName, $filter, $update, array $options = [])   X-Ref
Constructs a findAndModify command for updating a document.

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.

For servers < 3.2, this option is ignored as document level validation
is not available.

* collation (document): Collation specification.

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

* maxTimeMS (integer): The maximum amount of time to allow the query to
run.

* projection (document): Limits the fields to return for the matching
document.

* returnDocument (enum): Whether to return the document before or after
the update is applied. Must be either
FindOneAndUpdate::RETURN_DOCUMENT_BEFORE or
FindOneAndUpdate::RETURN_DOCUMENT_AFTER. The default is
FindOneAndUpdate::RETURN_DOCUMENT_BEFORE.

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

Sessions are not supported for server versions < 3.6.

* sort (document): Determines which document the operation modifies if
the query selects multiple documents.

* typeMap (array): Type map for BSON deserialization.

* 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.

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

param: string       $databaseName   Database name
param: string       $collectionName Collection name
param: array|object $filter         Query by which to filter documents
param: array|object $update         Update to apply to the matched document
param: array        $options        Command options

execute(Server $server)   X-Ref
Execute the operation.

param: Server $server
return: array|object|null

getCommandDocument(Server $server)   X-Ref
No description