Skip to content

Commit 44cb19c

Browse files
committed
tweak clients overview page
1 parent c5b72f8 commit 44cb19c

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

clients.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,13 @@ There are two types of libraries you can use to send HTTP messages; clients and
55
``HttpClient`` and/or the ``HttpAsyncClient`` interfaces directly. A client adapter is a class implementing the
66
interface and forwarding the calls to an HTTP client not implementing the interface. (See `Adapter pattern`_ on Wikipedia).
77

8+
.. hint::
9+
10+
Modern PHP clients implement the ``PSR-18 HTTP Client`` standard. If you want to do synchronous requests, you don't
11+
need a PHP-HTTP adapter anymore. We keep providing the the curl client and a mock client for testing.
12+
13+
The adapters are still useful if you need the PHP-HTTP ``HttpAsyncClient``.
14+
815
.. note::
916

1017
All clients and adapters comply with `Liskov substitution principle`_ which means that you can easily change one
@@ -29,13 +36,6 @@ interface and forwarding the calls to an HTTP client not implementing the interf
2936
Current Clients and Adapters
3037
----------------------------
3138

32-
.. hint::
33-
34-
Modern PHP clients implement the ``PSR-18 HTTP Client`` standard. If you want to do synchronous requests, you don't
35-
need a PHP-HTTP adapter anymore. We keep providing the the curl client and a mock client for testing.
36-
37-
The adapters are still useful if you need the PHP-HTTP ``HttpAsyncClient``.
38-
3939
.. csv-table::
4040
:header: "Name", "Type", "Links", "Stats"
4141
:widths: 32, 15, 15, 38
@@ -44,7 +44,6 @@ Current Clients and Adapters
4444
"``php-http/mock-client``", "Client", ":doc:`Docs </clients/mock-client>`, `Repo <https://github.com/php-http/mock-client>`__", "|mock_version| |mock_downloads| "
4545
"``symfony/http-client``", "Client", ":doc:`Docs </clients/symfony-client>`, `Repo <https://github.com/symfony/http-client>`__", "|symfony_version| |symfony_downloads| "
4646
"``php-http/artax-adapter``", "Adapter", ":doc:`Docs </clients/artax-adapter>`, `Repo <https://github.com/php-http/artax-adapter>`__", "|artax_version| |artax_downloads| "
47-
"``php-http/buzz-adapter``", "Adapter", ":doc:`Docs </clients/buzz-adapter>`, `Repo <https://github.com/php-http/buzz-adapter>`__", "|buzz_version| |buzz_downloads| "
4847
"``php-http/cakephp-adapter``", "Adapter", ":doc:`Docs </clients/cakephp-adapter>`, `Repo <https://github.com/php-http/cakephp-adapter>`__", "|cakephp_version| |cakephp_downloads| "
4948
"``php-http/guzzle7-adapter``", "Adapter", ":doc:`Docs </clients/guzzle7-adapter>`, `Repo <https://github.com/php-http/guzzle7-adapter>`__", "|guzzle7_version| |guzzle7_downloads| "
5049
"``php-http/react-adapter``", "Adapter", ":doc:`Docs </clients/react-adapter>`, `Repo <https://github.com/php-http/react-adapter>`__", "|react_version| |react_downloads| "
@@ -59,6 +58,7 @@ These are not maintained anymore, but we keep documentation around for now. Plea
5958
:widths: 32, 15, 15, 38
6059

6160
"``php-http/socket-client``", "Client", ":doc:`Docs </clients/socket-client>`, `Repo <https://github.com/php-http/socket-client>`__", "|socket_version| |socket_downloads| "
61+
"``php-http/buzz-adapter``", "Adapter", ":doc:`Docs </clients/buzz-adapter>`, `Repo <https://github.com/php-http/buzz-adapter>`__", "|buzz_version| |buzz_downloads| "
6262
"``php-http/guzzle5-adapter``", "Adapter", ":doc:`Docs </clients/guzzle5-adapter>`, `Repo <https://github.com/php-http/guzzle5-adapter>`__", "|guzzle5_version| |guzzle5_downloads| "
6363
"``php-http/guzzle6-adapter``", "Adapter", ":doc:`Docs </clients/guzzle6-adapter>`, `Repo <https://github.com/php-http/guzzle6-adapter>`__", "|guzzle6_version| |guzzle6_downloads| "
6464
"``php-http/zend-adapter``", "Adapter", ":doc:`Docs </clients/zend-adapter>`, `Repo <https://github.com/php-http/zend-adapter>`__", "|zend_version| |zend_downloads| "

0 commit comments

Comments
 (0)