在开发 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 请求的理想选择。
