sinacms/multihttp

a tool for multi-curl written in php

MultiHttp

, _(*1)

   This is high performance curl wrapper written in pure PHP. It's compatible with PHP 5.4+ and HHVM. Notice that libcurl version must be over 7.36.0, otherwise timeout can not suppert decimal., _(*2)

   这是一个高性能的PHP封装的HTTP Restful多线程并发请求库，参考借鉴了httpful 、multirequest等优秀的代码。它与PHP 5.4和hhvm兼容。 注意，libcurl版本必须>=7.36.0，否则超时不支持小数。, _(*3)

## 请使用最新 Tag ( Please use the latest tag version)

, _(*4)

Contents

• Feature
• Installation
• Usage
  • Single-request
  • Multi-request
• Documentation
  • Request
  • MultiRequest

Feature

• alias of curl option, e.g. 'timeout' equals 'CURLOPT_TIMEOUT' etc.
• Request and MultiRequest class , can be used in any combination
• graceful and efficient

Installation

You can use composer to install this library from the command line., _(*5)

composer require sinacms/multihttp

Usage

Single-request:

get('http://sina.com.cn', array(
          'timeout' => 3,
      'expects_mime'=>'json',
      'retry_times' => 3,
      'ip' => '127.0.0.1:8080',//alias for proxy, better than raw proxy
          'callback' => function (Response $response) {
              echo $response->body;
          },
          ))->send();
      
//method 2
$result = Request::create()->post(
      'http://127.0.0.1',array('data'=>'this_is_post_data'), array(
          'callback' => function (Response $response) {
              echo $response->body;
          }))->send();

``` 


### Multi-request:
 
```php
add('GET', 'http://sina.cn',array(), array(
                  'timeout' => 3,
                  'callback' => function (Response $response) {
                                  echo $response->body;
                              }
              ))
          ->add('GET', 'http://google.cn',array(), array(
                  'timeout' => 3,
                  'callback' => function (Response $response) {
                                  echo $response->body;
                              }
              ))    
          ->sendAll();

?>

Documentation

• Request

  • option shorthand

    'url'             => 'CURLOPT_URL',
    'debug'           => 'CURLOPT_VERBOSE',//for debug verbose
    'method'          => 'CURLOPT_CUSTOMREQUEST',
    'data'            => 'CURLOPT_POSTFIELDS', // array or string , file begin with '@'
    'ua'              => 'CURLOPT_USERAGENT',
    'timeout'         => 'CURLOPT_TIMEOUT', // (secs) 0 means indefinitely
    'connect_timeout' => 'CURLOPT_CONNECTTIMEOUT',
    'referer'         => 'CURLOPT_REFERER',
    'binary'          => 'CURLOPT_BINARYTRANSFER',
    'port'            => 'CURLOPT_PORT',
    'header'          => 'CURLOPT_HEADER', // TRUE:include header
    'headers'         => 'CURLOPT_HTTPHEADER', // array
    'download'        => 'CURLOPT_FILE', // writing file stream (using fopen()), default is STDOUT
    'upload'          => 'CURLOPT_INFILE', // reading file stream
    'transfer'        => 'CURLOPT_RETURNTRANSFER', // TRUE:return string; FALSE:output directly (curl_exec)
    'follow_location' => 'CURLOPT_FOLLOWLOCATION',
    'timeout_ms'      => 'CURLOPT_TIMEOUT_MS', // milliseconds,  libcurl version > 7.36.0 ,

  • public static function create(), _(*6)

  • public function endCallback()
  • public function hasEndCallback()
  • public function onEnd(callable$callback)
  • public function uri
  • public function getIni($field)
  • public function addQuery($data)
  • public function post($uri, array $payload = array(), array $options = array())
  • public function addOptions(array $options = array())
  • public function get($uri, array $options = array())
  • public function send()
  • public function applyOptions()
  • public function makeResponse($isMultiCurl = false)

• MultiRequest

  • public static function create()
  • public function addOptions(array $URLOptions)
  • public function add($method, $uri, array $payload = array(), array $options = array())
  • public function import(Request $request)
  • public function sendAll()

  [More]https://github.com/sinacms/MultiHttp/blob/master/usage.md, _(*7)