在開發 php 項目時，處理外部 api 請求常常是一項復雜且耗時的任務。最近，我在項目中遇到了這個問題：需要處理各種類型的 http 請求，包括 json、表單提交和文件上傳等。這些請求不僅需要精確的配置，還需要處理不同的認證方式和錯誤處理邏輯。嘗試了多種方法后，我發現 apimatic/unirest-php 這個庫大大簡化了我的工作。
使用 composer 安裝 apimatic/unirest-php 非常簡單，只需運行以下命令：
composer require apimatic/unirest-php
這個庫提供了一系列功能強大的工具來處理 HTTP 請求。以下是如何使用 apimatic/unirest-php 來解決常見的問題：
創建 HTTP 客戶端
首先，你可以創建一個帶有默認配置的 HTTP 客戶端：
private $httpClient = new UnirestHttpClient();
如果你需要自定義配置，可以使用 Configuration 類來設置超時時間、重試策略等：
立即學習“PHP免費學習筆記（深入）”；
$configurations = UnirestConfiguration::init() ->timeout(10) ->enableRetries(true) ->retryInterval(2.5); $httpClient = new UnirestHttpClient($configurations);
發送請求
apimatic/unirest-php 支持多種類型的請求，包括 JSON、表單和多部分請求。以下是一個 JSON 請求的例子：
$headers = array('Accept' => 'application/json'); $data = array('name' => 'ahmad', 'company' => 'mashape'); $body = UnirestRequestBody::Json($data); $request = new UnirestRequestRequest( 'http://mockbin.com/request', RequestMethod::POST, $headers, $body ); $response = $this->httpClient->execute($request);
對于表單請求，可以使用 UnirestRequestBody::Form 幫助函數：
$headers = array('Accept' => 'application/json'); $data = array('name' => 'ahmad', 'company' => 'mashape'); $body = UnirestRequestBody::Form($data); $request = new UnirestRequestRequest( 'http://mockbin.com/request', RequestMethod::POST, $headers, $body ); $response = $this->httpClient->execute($request);
文件上傳可以通過多部分請求實現：
$headers = array('Accept' => 'application/json'); $data = array('name' => 'ahmad', 'company' => 'mashape'); $files = array('bio' => '/path/to/bio.txt', 'avatar' => '/path/to/avatar.jpg'); $body = UnirestRequestBody::Multipart($data, $files); $request = new UnirestRequestRequest( 'http://mockbin.com/request', RequestMethod::POST, $headers, $body ); $response = $this->httpClient->execute($request);
處理響應
apimatic/unirest-php 會返回一個包含詳細信息的響應對象，你可以輕松地訪問狀態碼、頭信息和響應體：
$response->getStatusCode(); // HTTP 狀態碼 $response->getHeaders(); // 頭信息 $response->getBody(); // 解析后的響應體 $response->getRawBody(); // 未解析的響應體
認證和代理設置
如果你需要認證，可以通過 Configuration 類設置基本認證或其他認證方法：
$configuration = Configuration::init() ->auth('username', 'password', CURLAUTH_Basic);
代理設置也很簡單：
$configuration = Configuration::init() ->proxy('10.10.10.1', 8080, CURLPROXY_HTTP);
優勢和實際應用效果
使用 apimatic/unirest-php 后，我的項目在處理 HTTP 請求方面的復雜度顯著降低。它不僅簡化了請求的創建和配置，還提供了強大的錯誤處理和重試機制，使得整個系統更加穩定和可靠。無論是 JSON 請求、表單提交還是文件上傳，這個庫都提供了簡單而強大的解決方案，大大提高了開發效率。
總的來說，apimatic/unirest-php 是一個非常實用的工具，適用于任何需要處理復雜 HTTP 請求的 PHP 項目。它通過 Composer 輕松安裝，配置靈活，使用簡單，是處理 API 請求的理想選擇。
