document exception concept

[dbu]

most important is explaining in what situation which exception will be thrown and that everything ever thrown implements Http\Client\Exception.

Hierarchy is the following

\InvalidArgumentException
`- \Http\Client\Exception\InvalidArgumentException (implements \Http\Client\Exception)

\RuntimeException
`- \Http\Client\Exception\RuntimeException (implements \Http\Client\Exception)
   `- \Http\Client\Exception\TransferException
      |- \Http\Client\Exception\BatchException
      `- \Http\Client\Exception\RequestException
         |- \Http\Client\Exception\NetworkException
         `- \Http\Client\Exception\HttpException
            |- \Http\Client\Exception\ServerException
            `- \Http\Client\Exception\ClientException

[dbu]

i guess there are two parts:

• how to use the HttpClient and its exceptions (including an example in the tutorial, see Finalize tutorial #13)
• how to write a client / adapter and throw the correct exceptions

[sagikazarmark]

Agree 👍

[sagikazarmark]

php-http/httplug#82