Basic documentation of cache plugin methods option

plugins/cache.rst

@@ -36,18 +36,20 @@ control headers from the server as specified in :rfc:`7234`. It needs a
 Options
 -------
 
-The third parameter to the ``CachePlugin`` constructor takes an array of options. The plugin has 3 options you can
+The third parameter to the ``CachePlugin`` constructor takes an array of options. The plugin has four options you can
 configure. Their default values and meaning is described by the table below.
 
-+---------------------------+---------------+------------------------------------------------------+
-| Name                      | Default value | Description                                          |
-+===========================+===============+======================================================+
-| ``default_ttl``           | ``0``         | The default max age of a Response                    |
-+---------------------------+---------------+------------------------------------------------------+
-| ``respect_cache_headers`` | ``true``      | Whatever or not we should care about cache headers   |
-+---------------------------+---------------+------------------------------------------------------+
-| ``cache_lifetime``        | 30 days       | The minimum time we should store a cache item        |
-+---------------------------+---------------+------------------------------------------------------+
++---------------------------+---------------------+------------------------------------------------------+
+| Name                      | Default value       | Description                                          |
++===========================+=====================+======================================================+
+| ``default_ttl``           | ``0``               | The default max age of a Response                    |
++---------------------------+---------------------+------------------------------------------------------+
+| ``respect_cache_headers`` | ``true``            | Whatever or not we should care about cache headers   |
++---------------------------+---------------------+------------------------------------------------------+
+| ``cache_lifetime``        | 30 days             | The minimum time we should store a cache item        |
++---------------------------+---------------------+------------------------------------------------------+
+| ``methods``               | ``['GET', 'HEAD']`` | Which request methods to cache                       |
++---------------------------+---------------------+------------------------------------------------------+
 
 .. note::
 
@@ -103,7 +105,22 @@ removed from the cache::
         'cache_lifetime' => 86400*365, // one year
     ];
 
+Caching of different request methods
+````````````````````````````````````
 
+Most of the time you should not change the ``methods`` option. However if you are working for example with HTTPlug
+based SOAP client you might want to additionally enable caching of POST requests::
+
+    $options = [
+        'methods' => ['GET', 'HEAD', 'POST'],
+    ];
+
+You can cache any valid request method.
+
+.. note::
+
+    If your system has both normal and SOAP clients you need to use two different ``PluginClient`` instances. SOAP
+    client should use ``PluginClient`` with POST caching enabled and normal client with POST caching disabled.
 
 Cache Control Handling
 ----------------------