PHP-1309: Collection::replaceOne()

examples/write.php

@@ -81,6 +81,15 @@ try {
     foreach($result as $document) {
         var_dump($document);
     }
+    $result = $collection->replaceOne(
+        array("nick" => "Bobby Fischer"),
+        array("name" => "Magnus Carlsen", "nick" => "unknown", "citizen" => "Norway")
+    );
+    printf("Replaced: %d (out of expected 1), verify Bobby has been replaced with Magnus\n", $result->getNumModified());
+    $result = $collection->find();
+    foreach($result as $document) {
+        var_dump($document);
+    }
 
     $result = $collection->deleteMany(array("citizen" => "Iceland"));
     printf("Deleted: %d (out of expected 3)\n", $result->getNumRemoved());

src/Collection.php

@@ -209,9 +209,18 @@ class Collection {
     function deleteMany(array $filter) { /* {{{ */
         return $this->_writeSingle($filter, self::DELETE, array("limit" => 0));
     } /* }}} */
-    function updateOne(array $filter, $update, array $options = array()) { /* {{{ */
+    function updateOne(array $filter, array $update, array $options = array()) { /* {{{ */
+        if (key($update)[0] != '$') {
+            throw new \RuntimeException("First key in \$update must be a \$operator");
+        }
         return $this->_writeSingle($filter, self::UPDATE, $options, $update);
     } /* }}} */
+    function replaceOne(array $filter, array $update, array $options = array()) { /* {{{ */
+        if (key($update)[0] == '$') {
+            throw new \RuntimeException("First key in \$update must NOT be a \$operator");
+        }
+        return $this->_writeSingle($filter, self::UPDATE, $options, array('$set' => $update));
+    } /* }}} */
     function updateMany(array $filter, $update, array $options = array()) { /* {{{ */
         return $this->_writeSingle($filter, self::UPDATE, $options + array("limit" => 0), $update);
     } /* }}} */