stk2k/grasshopper

cURL的薄封装类库

0.8.1 2018-01-24 17:30 UTC

README

描述

Grasshopper 是一个 cURL PHP 库,可以轻松发送 HTTP 请求。此库可以一次性处理多个请求。

特性

  • 支持在一次调用中处理多个请求
  • 易于使用:简单接口
  • 丰富的错误处理:支持过程式或回调

演示

use Grasshopper\Grasshopper;
use \Grasshopper\event\SuccessEvent;
use \Grasshopper\event\ErrorEvent;
 
$hopper = new Grasshopper();

$url = 'http://example.com';

$hopper->addRequest($url);

$result = $hopper->waitForAll();

$res = $result[$url];
if ( $res instanceof SuccessEvent ){
    // success
    $status = $res->getResponse()->getStatusCode();
    $body = $res->getResponse()->getBody();
    echo "success: status=$status" . PHP_EOL;
    echo $body . PHP_EOL;
}
elseif ( $res instanceof ErrorEvent ){
    // error
    echo "error: " . $res->getError()->getMessage() . PHP_EOL;
}
 

用法

  1. 创建 grasshopper 对象。
  2. 将 HttpGet/HttpPostRequest 添加到 grasshopper 对象中。
  3. 执行 Grasshopper#waitforAll() 方法。
  4. 从返回的数组中获取响应。键是请求的 URL。
  5. 检查响应对象是否为 SuccessEvent 或 ErrorEvent。SuccessEvent 表示请求成功,ErrorEvent 表示失败。
  6. 您可以从 SuccessEvent 获取响应对象。它提供状态码和响应体。
  7. 您可以从 ErrorEvent 获取错误信息。它提供错误代码和消息。

需求

PHP 5.5 或更高版本

安装 Grasshopper

推荐通过 Composer 安装 Grasshopper。

composer require stk2k/grasshopper

安装后,您需要包含 Composer 的自动加载器

require 'vendor/autoload.php';

许可协议

MIT

作者

stk2k

免责声明

本软件无任何保修。

我们不承担使用本软件造成的任何后果。

请自行承担责任。