[TOC] ## 安裝 ``` composer require psr/http-client ``` ## 接口 <details> <summary>Psr\Http\Client\ClientInterface</summary> ``` namespace Psr\Http\Client; use Psr\Http\Message\RequestInterface; use Psr\Http\Message\ResponseInterface; interface ClientInterface { /** * 發送一個 PSR-7 標準的請求，返回一個 PSR-7 格式的響應. * * @param RequestInterface $request * * @return ResponseInterface * * @throws \Psr\Http\Client\ClientExceptionInterface 發生錯誤將拋出客戶端異常接口對象 * */ public function sendRequest(RequestInterface $request): ResponseInterface; } ``` </details> <br /> <details> <summary>Psr\Http\Client\ClientExceptionInterface</summary> ``` namespace Psr\Http\Client; /** * 每個HTTP客戶端相關的異常都必須實現此接口. */ interface ClientExceptionInterface extends \Throwable { } ``` </details> <br /> <details> <summary>Psr\Http\Client\RequestExceptionInterface</summary> ``` namespace Psr\Http\Client; use Psr\Http\Message\RequestInterface; /** * 請求失敗時的異常. * * 舉例: * - 請求無效 (e.g. 參數缺失) * - 請求運行錯誤 (e.g. 響應體不可見) */ interface RequestExceptionInterface extends ClientExceptionInterface { /** * 獲取請求對象. * * 請求對象可能和客戶端接口發送的對象不一致. * * @return RequestInterface */ public function getRequest(): RequestInterface; } ``` </details> <br /> <details> <summary>Psr\Http\Client\NetworkExceptionInterface</summary> ``` namespace Psr\Http\Client; use Psr\Http\Message\RequestInterface; /** * 因網絡原因導致請求無法完成時拋出該異常. * * 拋出該異常將沒有響應體，因為收不到響應體時也會拋出這個異常. * * 舉例：域名不能解析或連接失敗. */ interface NetworkExceptionInterface extends ClientExceptionInterface { /** * 返回請求對象. * * 返回的請求對象可能和客戶端接口發送的對象不一致. * * @return RequestInterface */ public function getRequest(): RequestInterface; } ``` </details> <br />