International PHP Conference Munich 2025

MongoDB\Driver\BulkWriteCommandResult::getInsertResults

(mongodb >=2.1.0)

MongoDB\Driver\BulkWriteCommandResult::getInsertResultsRenvoie les résultats détaillés des insertions réussies

Description

final public MongoDB\Driver\BulkWriteCommandResult::getInsertResults(): ?MongoDB\BSON\Document

Depuis que les champs _id des documents insérés sont générés par l'extension, la valeur de insertedId dans chaque résultat correspondra à la valeur de retour de MongoDB\Driver\BulkWriteCommand::insertOne() pour l'opération d'insertion correspondante.

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

Renvoie un document contenant les résultats de chaque opération d'insertion ou null si les résultats détaillés n'ont pas été demandés. Les clés du document correspondront à l'index de l'opération d'écriture de MongoDB\Driver\BulkWriteCommand.

Erreurs / Exceptions

  • Lance une exception MongoDB\Driver\InvalidArgumentException lors d'une erreur survenue pendant l'analyse d'un argument.
  • Lève une exception MongoDB\Driver\Exception\LogicException si l'écriture n’a pas été reconnue.

Exemples

Exemple #1 Exemple de MongoDB\Driver\BulkWriteCommandResult::getInsertResults()

<?php

$manager
= new MongoDB\Driver\Manager;

$bulk = new MongoDB\Driver\BulkWriteCommand(['verboseResults' => true]);

$generatedId = $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($generatedId);

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

?>

Résultat de l'exemple ci-dessus est similaire à :

object(MongoDB\BSON\ObjectId)#3 (1) {
  ["oid"]=>
  string(24) "67f7ee69783dcce702097b41"
}
object(stdClass)#8 (1) {
  ["0"]=>
  object(stdClass)#7 (1) {
    ["insertedId"]=>
    object(MongoDB\BSON\ObjectId)#6 (1) {
      ["oid"]=>
      string(24) "67f7ee69783dcce702097b41"
    }
  }
}

Voir aussi

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top