Raise exceptions when write errors occur during updates

[thekid]

This pull request changes update() and upsert() to raise exceptions when write errors occur during the following:

use com\mongodb\MongoConnection;

$c= new MongoConnection($dsn);
$c->collection('test.entries')->upsert(['test' => true], [
  '$inc' => ['version' => 1],
  '$setOnInsert' => ['version' => 1],
]);

This yields the following in the result:

writeErrors => [[
  index => 0
  code => 40
  errmsg => "Updating the path 'version' would create a conflict at 'version'"
]]

👉 The methods now throw a com.mongodb.WriteErrors exception which extends the com.mongodb.Error class.

Accessing the errors

use com\mongodb\{MongoConnection, WriteErrors};
use util\cmd\Console;

$c= new MongoConnection($dsn);
try {
  $c->collection('test.entries')->upsert(['test' => true], [
    '$inc' => ['version' => 1],
    '$setOnInsert' => ['version' => 1],
  ]);
} catch (WriteErrors $errors) {
  Console::writeLine('The following errors occurred: ', $errors->list());
}

See also

• Make writeErrors accessible #54
• https://www.mongodb.com/docs/manual/reference/command/update/#mongodb-data-update.writeErrors
• https://www.php.net/manual/en/mongodb-driver-writeresult.getwriteerrors.php

[thekid]

Released in https://github.com/xp-forge/mongodb/releases/tag/v3.2.0