diff --git a/clients/buzz-adapter.rst b/clients/buzz-adapter.rst index 9a86878..f241dfa 100644 --- a/clients/buzz-adapter.rst +++ b/clients/buzz-adapter.rst @@ -54,6 +54,15 @@ Or if you installed the :doc:`discovery ` layer:: The message factory parameter is mandatory if the discovery layer is not installed. +Be aware +-------- + +This adapter violates the Liskov substitution principle in a rare edge case. When the adapter is configured to use +Buzz' Curl client, it does not send request bodies for request methods such as GET, HEAD and TRACE. A ``RequestException`` +will be thrown if this ever happens. + +If you need GET request with a body (e.g. for Elasticsearch) you need to use the Buzz FileGetContents client or choose a different HTTPlug client like Guzzle 6. + .. include:: includes/further-reading-sync.inc .. _Buzz HTTP client: https://github.com/kriswallsmith/Buzz diff --git a/spelling_word_list.txt b/spelling_word_list.txt index 21f86fe..851b255 100644 --- a/spelling_word_list.txt +++ b/spelling_word_list.txt @@ -5,9 +5,11 @@ boolean callables cURL Diactoros +Elasticsearch fallback GitHub hotfix +Liskov Symfony HTTPlug Ivory