MultiHttp

   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.

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

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

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.

composer require sinacms/multihttp

Usage

Single-request:

<?php
// Include Composer's autoload file if not already included.
require_once __DIR__.'/vendor/autoload.php';
use MultiHttp\Request;
use MultiHttp\Response;

//method 1
Request::create()->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
require_once __DIR__.'/vendor/autoload.php';
use MultiHttp\MultiRequest;
use MultiHttp\Response;


$mr  = MultiRequest::create();
$rtn = $mr->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()

• 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