Allow setting custom options on a query [Fixes mongodb#541]

Author: Ryan Hayle

src/Jenssegers/Mongodb/Query/Builder.php

@@ -41,6 +41,13 @@ class Builder extends BaseBuilder
      */
     public $hint;
 
+    /**
+     * Custom options to add to the query.
+     *
+     * @var array
+     */
+    public $options = [];
+
     /**
      * Indicate if we are executing a pagination query.
      *
@@ -255,6 +262,11 @@ public function getFresh($columns = [])
                 'typeMap' => ['root' => 'array', 'document' => 'array'],
             ];
 
+            // Add custom query options
+            if (count($this->options)) {
+                $options = array_merge($options, $this->options);
+            }
+
             // Execute aggregation
             $results = iterator_to_array($this->collection->aggregate($pipeline, $options));
 
@@ -313,6 +325,11 @@ public function getFresh($columns = [])
             // Fix for legacy support, converts the results to arrays instead of objects.
             $options['typeMap'] = ['root' => 'array', 'document' => 'array'];
 
+            // Add custom query options
+            if (count($this->options)) {
+                $options = array_merge($options, $this->options);
+            }
+
             // Execute query and get MongoCursor
             $cursor = $this->collection->find($wheres, $options);
 
@@ -1020,6 +1037,19 @@ protected function compileWhereRaw($where)
         return $where['sql'];
     }
 
+    /**
+     * Set custom options for the query.
+     *
+     * @param  array  $options
+     * @return $this
+     */
+    public function options(array $options)
+    {
+        $this->options = $options;
+
+        return $this;
+    }
+
     /**
      * Handle dynamic method calls into the method.
      *