Adding fetch support to Result for dot notation fetching.

Adding __get support to alias the fetch function.
Created test cases.

Author: mhh1422

.gitignore

@@ -41,6 +41,20 @@ To do so, you need to create the method name you wish as protected in the query
 You can extend the Model class easily. Just extend it!
 In case you were using the namespaces, you can set the models namespace in the query class by overriding the modelNamespace public method. This method should return a string ending with \
 
+##Retrieving results
+The returned result set implements the ArrayAccess interface to access specific document inside the result. i.e.
+```PHP
+$result = SomeQuery::all();
+```
+You can then get a document like this:
+```PHP
+$doc = $result[1]; //gets the second document
+```
+Or you can use the dot notation like that:
+```
+$result->fetch('hits.hits.0'); //for any absolute access
+```
+
 ##Examples
 Please check [tests/](/tests) folder. Basically, the case1.php is the main file.
 

LICENSE

@@ -229,4 +229,28 @@ public function first() {
         }
     }
 
+    /**
+     * Gets specific value from within the result set using dot notation
+     * 
+     * The path should be absolution from the beginning, and include the normal 
+     * elastic search structure depending on the query type
+     * 
+     * @param string $path
+     */
+    public function fetch($path) {
+        $result = $this->result;
+        $keys = explode(".", $path);
+        foreach ($keys as $key) {
+            if (!array_key_exists($key, $result)) {
+                return null;
+            }
+            $result = $result[$key];
+        }
+        return $result;
+    }
+
+    public function __get($name) {
+        return $this->fetch($name);
+    }
+
 }

README.md

@@ -0,0 +1,35 @@
+<?php
+
+/* * ***
+ * All the examples suppose there is an ES instance with the following 
+ * index/type/doc architecture:
+ * 
+ *  - tests
+ *      - foo
+ *          - foo1: {name: Fooa, id: 1, age: 33, alive: true}
+ *          - foo2: {name: Foob, id: 2, age: 18, alive: false}
+ *      - bar
+ *          - bar1: {name: 
+ *          - bar2
+ */
+
+require '../vendor/autoload.php';
+
+require_once 'TestsIndexQuery.php';
+require_once 'FooTypeQuery.php';
+require_once 'BarTypeQuery.php';
+require_once 'FooModel.php';
+require_once 'BarModel.php';
+
+$result = Tests\FooTypeQuery::query([
+            "size" => 0,
+            "aggregations" => [
+                "alive" => [
+                    "terms" => [
+                        "field" => "alive"
+                    ]
+                ]
+            ]
+        ]);
+
+var_dump($result->fetch('aggregations.alive'));