PHP-1313: Implement Collection::findOneAndDelete()

Author: bjori

examples/write.php

@@ -136,6 +136,15 @@
     echo "Kasparov\n";
     var_dump($result);
 
+    echo "Deleting him, he isn't Croatian just yet\n";
+    $result = $collection->findOneAndDelete(array("citizen" => "Croatia"));
+    var_dump($result);
+
+    echo "This should be empty\n";
+    $result = $collection->find(array());
+    foreach($result as $document) {
+        var_dump($document);
+    }
 } catch(Exception $e) {
     printf("Caught exception '%s', on line %d\n", $e->getMessage(), __LINE__);
     exit;

src/MongoDB/Collection.php

@@ -368,6 +368,46 @@ protected function _massageAggregateOptions($options) { /* {{{ */
     } /* }}} */
 
     /* {{{ findAndModify */
+    function findOneAndDelete(array $filter, array $options = array()) { /* {{{ */
+        $options = array_merge($this->getFindOneAndDeleteOptions(), $options);
+        $options = $this->_massageFindAndModifyOptions($options);
+        $cmd = array(
+            "findandmodify" => $this->collname,
+            "query"         => $filter,
+        ) + $options;
+
+        $doc = $this->_runCommand($this->dbname, $cmd)->getResponseDocument();
+        if ($doc["ok"]) {
+            return $doc["value"];
+        }
+
+        throw $this->_generateCommandException($doc);
+    } /* }}} */
+    function getFindOneAndDeleteOptions() { /* {{{ */
+        return array(
+
+            /**
+             * The maximum amount of time to allow the query to run.
+             *
+             * @see http://docs.mongodb.org/manual/reference/command/findAndModify/
+             */
+            "maxTimeMS" => 0,
+
+            /**
+             * Limits the fields to return for all matching documents.
+             *
+             * @see http://docs.mongodb.org/manual/tutorial/project-fields-from-query-results
+             */
+            "projection" => array(),
+
+            /**
+             * Determines which document the operation modifies if the query selects multiple documents.
+             *
+             * @see http://docs.mongodb.org/manual/reference/command/findAndModify/
+             */
+            "sort" => array(),
+        );
+    } /* }}} */
 
     function findOneAndReplace(array $filter, array $replacement, array $options = array()) { /* {{{ */
         if (key($replacement)[0] == '$') {