Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stk2k/grasshopper
PHP HTTP Multi Request Client based on cURL
https://github.com/stk2k/grasshopper
curl php
Last synced: 2 days ago
JSON representation
PHP HTTP Multi Request Client based on cURL
- Host: GitHub
- URL: https://github.com/stk2k/grasshopper
- Owner: stk2k
- License: mit
- Created: 2016-01-04T01:57:21.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2018-01-24T17:32:17.000Z (almost 7 years ago)
- Last Synced: 2024-11-24T20:03:16.781Z (about 1 month ago)
- Topics: curl, php
- Language: PHP
- Homepage:
- Size: 75.2 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.ja.md
- License: LICENSE
Awesome Lists containing this project
README
Grasshopper, PHP HTTP Multi Request Client
=======================
## 説明
GrasshopperはもうひとつのPHP用cURLライブラリで、HTTPリクエストの送信を簡単にします。
このライブラリは一度に複数のリクエストを処理することができます。
## 特徴
- １度の呼び出しで複数のリクエストを処理できます。
- 簡単に使えます: インタフェースがシンプル
- 様々なエラーハンドリング: 手続き型とコールバックに対応
## デモ
```php
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. Grashopperオブジェクトを作成します。
2. HttpGet/HttpPostRequestオブジェクトを生成し、Grashopperオブジェクトに追加します。
3. Grasshopper#waitforAll()メソッドを実行します。
4. 返却された配列からレスポンスを取得します。配列のキーはリクエスト時のURLになっています。
5. レスポンスがSuccessEventであるかErrorEventであるか確認します。SuccessEventはリクエストが成功したことを表し, ErrorEventは失敗を表します。
6. SuccessEventからはレスポンスオブジェクトを取得できます。これはステータスコードとレスポンスボディを含んでいます。
7. ErrorEventからはエラー情報を取得できます。エラー情報はエラーコードやエラーメッセージを含んでいます。
## 要件
PHP 5.5 かまたはそれ以上
## Grasshopperのインストール方法
GrasshopperのインストールはComposerからのインストールが便利です。
[Composer](http://getcomposer.org).
```bash
composer require stk2k/grasshopper
```
インストール後、Composerのオートローダーを以下のようにrequireしてください。
```php
require 'vendor/autoload.php';
```
## ライセンス
[MIT](https://github.com/stk2k/grasshopper/blob/master/LICENSE)
## 作者
[stk2k](https://github.com/stk2k)
## 免責事項
このソフトウェアは無保証です。
私たちはこのソフトウェアによるいかなる結果も責任を負いません。
あなた自身の責任においてこのソフトウェアを使用するようにしてください。