Home/ Manual/ driver / manager/ MongoDB\Driver\Manager::executeWriteCommand

MongoDB\Driver\Manager::executeWriteCommand

PHP function Edit on GitHub ✎

(mongodb >=1.4.0)

Execute a database command that writes

Description

MongoDB\Driver\Manager::executeWriteCommand(string $db, MongoDB\Driver\Command $command, array|null $options = null): MongoDB\Driver\Cursor

Executes the command on the primary server.

This method will apply logic that is specific to commands that write (e.g. drop). The default value for the "writeConcern" option will be inferred from an active transaction (indicated by the "session" option), followed by the connection URI.

Note

This method is not intended to be used to execute insert, update, or delete commands. Users are encouraged to use MongoDB\Driver\Manager::executeBulkWrite() for those operations.

Parameters

options

Option	Type	Description

TransactionReadWriteConcern

Return Values Cursor

Errors/Exceptions

Throws MongoDB\Driver\Exception\RuntimeException on other errors (e.g. invalid command).

Changelog

Version	Description
PECL mongodb 1.4.4	`MongoDB\Driver\Exception\InvalidArgumentException` will be thrown if the `"session"` option is used in combination with an unacknowledged write concern.