Merge remote-tracking branch '5.x' into 6.x

# Conflicts:
#	composer.json

Author: Simonas Šerlinskas

Diff for: docs/Query/Span/SpanNear.md

@@ -1 +1,40 @@
-Documentation in progress...
+# Span Near Query
+
+> More info about span near query is in the [official elasticsearch docs][1]
+
+Matches spans which are near one another. One can specify slop, the maximum number of intervening unmatched positions, as well as whether matches are required to be in-order. The span near query maps to Lucene SpanNearQuery. Here is an example:
+
+## Simple example
+
+```JSON
+{
+    "query": {
+        "span_near" : {
+            "clauses" : [
+                { "span_term" : { "field" : "value1" } },
+                { "span_term" : { "field" : "value2" } },
+                { "span_term" : { "field" : "value3" } }
+            ],
+            "slop" : 12,
+            "in_order" : false
+        }
+    }
+}
+```
+
+In DSL:
+
+```php
+$search = new Search();
+$spanNearQuery = new SpanNearQuery();
+$spanNearQuery->addQuery(new SpanTermQuery('field', 'value1'));
+$spanNearQuery->addQuery(new SpanTermQuery('field', 'value2'));
+$spanNearQuery->addQuery(new SpanTermQuery('field', 'value3'));
+$spanNearQuery->addParameter('slop', 12);
+$spanNearQuery->addParameter('in_order', false);
+$search->addQuery($spanNearQuery);
+
+$queryArray = $search->toArray();
+```
+
+[1]: https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-span-near-query.html

Diff for: src/BuilderBag.php

@@ -43,7 +43,7 @@ public function add(BuilderInterface $builder)
         if (method_exists($builder, 'getName')) {
             $name = $builder->getName();
         } else {
-            $name = uniqid();
+            $name = bin2hex(random_bytes(30));
         }
 
         $this->bag[$name] = $builder;

Diff for: src/Query/Joining/NestedQuery.php

@@ -67,4 +67,24 @@ public function toArray()
             )
         ];
     }
+
+    /**
+     * Returns nested query object.
+     *
+     * @return BuilderInterface
+     */
+    public function getQuery()
+    {
+        return $this->query;
+    }
+
+    /**
+     * Returns path this query is set for.
+     *
+     * @return string
+     */
+    public function getPath()
+    {
+        return $this->path;
+    }
 }

Diff for: src/Search.php

@@ -663,6 +663,8 @@ public function addUriParam($name, $value)
             'lenient',
             'explain',
             '_source',
+            '_source_exclude',
+            '_source_include',
             'stored_fields',
             'sort',
             'track_scores',

Diff for: src/SearchEndpoint/AbstractSearchEndpoint.php

@@ -37,7 +37,7 @@ public function add(BuilderInterface $builder, $key = null)
         }
 
         if (!$key) {
-            $key = uniqid();
+            $key = bin2hex(random_bytes(30));
         }
 
         $this->container[$key] = $builder;