PHPC-734: Query "collation" option

Author: jmikola

src/MongoDB/Query.c

@@ -255,6 +255,7 @@ static bool php_phongo_query_init(php_phongo_query_t *intern, zval *filter, zval
 	PHONGO_QUERY_OPT_BOOL("allowPartialResults", options, "allowPartialResults");
 	PHONGO_QUERY_OPT_BOOL("awaitData", options, "awaitData");
 	PHONGO_QUERY_OPT_INT64("batchSize", options, "batchSize");
+	PHONGO_QUERY_OPT_DOCUMENT("collation", options, "collation");
 	PHONGO_QUERY_OPT_STRING("comment", options, "comment")
 		else PHONGO_QUERY_OPT_STRING("comment", modifiers, "$comment");
 	PHONGO_QUERY_OPT_BOOL("exhaust", options, "exhaust");

tests/query/query-ctor-002.phpt

@@ -9,6 +9,7 @@ var_dump(new MongoDB\Driver\Query(
         'allowPartialResults' => false,
         'awaitData' => false,
         'batchSize' => 10,
+        'collation' => ['locale' => 'en_US'],
         'comment' => 'foo',
         'exhaust' => false,
         'limit' => 20,
@@ -62,6 +63,11 @@ object(MongoDB\Driver\Query)#%d (%d) {
     bool(false)
     ["batchSize"]=>
     int(10)
+    ["collation"]=>
+    object(stdClass)#3 (1) {
+      ["locale"]=>
+      string(5) "en_US"
+    }
     ["comment"]=>
     string(3) "foo"
     ["exhaust"]=>

tests/query/query-ctor_error-002.phpt

@@ -7,6 +7,7 @@ require_once __DIR__ . '/../utils/tools.php';
 
 $tests = [
     ['modifiers' => 0],
+    ['collation' => 0],
     ['comment' => 0],
     ['hint' => 0],
     ['max' => 0],
@@ -33,6 +34,9 @@ foreach ($tests as $options) {
 OK: Got MongoDB\Driver\Exception\InvalidArgumentException
 Expected "modifiers" option to be array, integer given
 
+OK: Got MongoDB\Driver\Exception\InvalidArgumentException
+Expected "collation" option to be array or object, integer given
+
 OK: Got MongoDB\Driver\Exception\InvalidArgumentException
 Expected "comment" option to be string, integer given