Merge pull request #1107 from szabosteve/7.x.drs.config

[7.x][DOCS] Adds Configuration section to PHP docs

Author: szabosteve

docs/community.asciidoc

@@ -12,7 +12,6 @@ and elasticsearch-php client. You can easily build any {es} query and transform
 it to an array.
 __________________________
 
-
 [discrete]
 === elasticsearcher
 
@@ -26,7 +25,6 @@ application. It does not want to hide or replace functionality of the {es} PHP
 client.
 __________________________
 
-
 [discrete]
 === ElasticSearchQueryDSL
 
@@ -87,6 +85,7 @@ include:
 - Listeners for Doctrine events for automatic indexing.
 __________________________
 
+
 [discrete]
 === Drupal
 
@@ -114,6 +113,7 @@ __________________________
 This is a Laravel (4+) Service Provider for the official {es} low-level client.
 __________________________
 
+
 [discrete]
 ==== cviebrock/Laravel-Elasticsearch
 
@@ -124,6 +124,7 @@ __________________________
 An easy way to use the official {es} client in your Laravel applications.
 __________________________
 
+
 [discrete]
 ==== Plastic
 

docs/config-hash.asciidoc

@@ -0,0 +1,44 @@
+[discrete]
+[[config-hash]]
+=== Building the client from a configuration hash
+
+To help ease automated building of the client, all configurations can be 
+provided in a setting hash instead of calling the individual methods directly. 
+This functionality is exposed through the `ClientBuilder::FromConfig()` static 
+method, which accepts an array of configurations and returns a fully built 
+client.
+
+Array keys correspond to the method name, for example `retries` key corresponds 
+to `setRetries()` method.
+
+[source,php]
+----
+$params = [
+    'hosts' => [
+        'localhost:9200'
+    ],
+    'retries' => 2,
+    'handler' => ClientBuilder::singleHandler()
+];
+$client = ClientBuilder::fromConfig($params);
+----
+
+
+Unknown parameters throw an exception, to help the user find potential problems. 
+If this behavior is not desired (for example, you are using the hash for other 
+purposes, and may have keys unrelated to the {es} client), you can set 
+$quiet = true in fromConfig() to silence the exceptions.
+
+[source,php]
+----
+$params = [
+    'hosts' => [
+        'localhost:9200'
+    ],
+    'retries' => 2,
+    'imNotReal' => 5
+];
+
+// Set $quiet to true to ignore the unknown `imNotReal` key
+$client = ClientBuilder::fromConfig($params, true);
+----