php8.5
Home/ Manual/ driver / bulkwritecommandresult/ MongoDB\Driver\BulkWriteCommandResult::getUpdateResults

MongoDB\Driver\BulkWriteCommandResult::getUpdateResults

PHP function Edit on GitHub ✎

(mongodb >=2.1.0)

Returns verbose results for successful updates

Description

MongoDB\Driver\BulkWriteCommandResult::getUpdateResults(): MongoDB\BSON\Document|null

Parameters Parameters

Return Values

Returns a document containing the result of each successful update operation, or null if verbose results were not requested. The document keys will correspond to the index of the write operation from MongoDB\Driver\BulkWriteCommand.

Errors/Exceptions

Examples

MongoDB\Driver\BulkWriteCommandResult::getUpdateResults() example

php
<?php

$manager = new MongoDB\Driver\Manager;

$bulk = new MongoDB\Driver\BulkWriteCommand(['verboseResults' => true]);
$bulk->insertOne('db.coll', ['x' => 1]);
$bulk->updateOne('db.coll', ['x' => 1], ['$set' => ['y' => 3]]);
$bulk->updateOne('db.coll', ['x' => 2], ['$set' => ['y' => 1]], ['upsert' => true]);
$bulk->updateOne('db.coll', ['x' => 3], ['$set' => ['y' => 2]], ['upsert' => true]);
$bulk->deleteMany('db.coll', []);

$result = $manager->executeBulkWriteCommand($bulk);

var_dump($result->getUpdateResults()->toPHP());

?>

The above example will output something similar to:

output
object(stdClass)#16 (3) {
  ["1"]=>
  object(stdClass)#7 (2) {
    ["matchedCount"]=>
    object(MongoDB\BSON\Int64)#5 (1) {
      ["integer"]=>
      string(1) "1"
    }
    ["modifiedCount"]=>
    object(MongoDB\BSON\Int64)#6 (1) {
      ["integer"]=>
      string(1) "1"
    }
  }
  ["2"]=>
  object(stdClass)#11 (3) {
    ["matchedCount"]=>
    object(MongoDB\BSON\Int64)#8 (1) {
      ["integer"]=>
      string(1) "1"
    }
    ["modifiedCount"]=>
    object(MongoDB\BSON\Int64)#9 (1) {
      ["integer"]=>
      string(1) "0"
    }
    ["upsertedId"]=>
    object(MongoDB\BSON\ObjectId)#10 (1) {
      ["oid"]=>
      string(24) "67f7eb9b1f198bbcb880d575"
    }
  }
  ["3"]=>
  object(stdClass)#15 (3) {
    ["matchedCount"]=>
    object(MongoDB\BSON\Int64)#12 (1) {
      ["integer"]=>
      string(1) "1"
    }
    ["modifiedCount"]=>
    object(MongoDB\BSON\Int64)#13 (1) {
      ["integer"]=>
      string(1) "0"
    }
    ["upsertedId"]=>
    object(MongoDB\BSON\ObjectId)#14 (1) {
      ["oid"]=>
      string(24) "67f7eb9b1f198bbcb880d576"
    }
  }
}

See Also

  • MongoDB\Driver\BulkWriteCommandResult::getMatchedCount
  • MongoDB\Driver\BulkWriteCommandResult::getModifiedCount
  • MongoDB\Driver\BulkWriteCommandResult::getUpsertedCount
  • MongoDB\Driver\BulkWriteCommandResult::isAcknowledged

Source: reference/mongodb/mongodb/driver/bulkwritecommandresult/getupdateresults.xml · from the official PHP manual (php/doc-en)