Merge branch '2.0'

README.md

@@ -361,3 +361,36 @@ Any setting can be specified when declaring a type. For example, to enable a cus
                     blog:
                         mappings:
                             title: { boost: 8, analyzer: my_analyzer }
+
+### Overriding the Client class to suppress exceptions
+
+By default, exceptions from the Elastica client library will propogate through
+the bundle's Client class. For instance, if the elasticsearch server is offline,
+issuing a request will result in an `Elastica_Exception_Client` being thrown.
+Depending on your needs, it may be desirable to suppress these exceptions and
+allow searches to fail silently.
+
+One way to achieve this is to override the `foq_elastica.client.class` service
+container parameter with a custom class. In the following example, we override
+the `Client::request()` method and return the equivalent of an empty search
+response if an exception occurred.
+
+```
+<?php
+
+namespace Acme\ElasticaBundle;
+
+use FOQ\ElasticaBundle\Client as BaseClient;
+
+class Client extends BaseClient
+{
+    public function request($path, $method, $data = array())
+    {
+        try {
+            return parent::request($path, $method, $data);
+        } catch (\Elastica_Exception_Abstract $e) {
+            return new \Elastica_Response('{"took":0,"timed_out":false,"hits":{"total":0,"max_score":0,"hits":[]}}');
+        }
+    }
+}
+```