steady-as-hill/sooh-curl

curl

curl 封装

ServiceProxy项目（基于http协议的微服务中间件）需要扩展curl,原版本扩展性较差，因此有了这次的重构, _(*1)

基本用法

先看两个例子, _(*2)

    $ret = \Sooh\Curl::getInstance()->httpGet('http://www.baidu.com');
    echo "httpCode:".$ret->httpCode."\n";
    echo "content:".$ret->body."\n";
    echo "new cookies set:".json_encode($ret->newCookies)."\n";

稍微复杂些的, _(*3)

    //前期初始化
    $curl = \Sooh\Curl::getInstance(array('SESSIONID'=>'afasdf'),new \Sooh\CurlClasses\Headers(array('some-header: value','other-header'=>'value')));

    //第一次请求，标准post
    $curl->disposables('Cookies',array('CookieTest'=>1))->httpPost('http://1.2.3.4/adsf',array('a'=>1));
    //此次服务器收到的请求，cookie 有两个SESSIONID=afasdf 和 CookieTest=1

    后面第二次请求，rawdata方式提交了个json数据
    $curl->disposables('Cookies',array('CookieAgain'=>2))->httpRawJson('http://1.2.3.4/adsf',array('a'=>1));
    //此次服务器收到的请求，cookie 有两个SESSIONID=afasdf 和 CookieAgain=2

初始化 及 设置

static function getInstance() 肩负初始化和获取实例的双重责任, _(*4)

初始化时会登记一些addons，比如cookie,此时记录的数据，在释放前全程有效, _(*5)

后面处理业务的时候，可以通过->disposables(addons名称，参数)， 调用指定addone的disposables方法，记录一些一次性的数据，在接下来的请求中用掉, _(*6)

说明：初始化的时候，getInstance()可以接收不定数量的参数， 除了cookie(可以给数组，内部转成Addons),其他都必须是Addons的实例, _(*7)

三种请求格式

public function httpGet($url,$params=null,$timeOut = 5), _(*8)

public function httpPost($url,$params,$timeOut=5), _(*9)

public function httpRawJson($url, $params,$timeOut=5), _(*10)

函数名可以说明问题了，这里只说明一下，params 根据具体的函数情况，string 或 array 都支持, _(*11)

返回结果，下面的结构应该不用多解释了, _(*12)

    class Ret {
        public $httpCode;
        public $newCookies=array();
        public $body;
        public $error;
        ……

addons

目前提供了四个Addons, _(*13)

1. Header的
2. proxy代理设置的
3. 标准Cookie的
4. ServiceProxy项目使用的CookiesForServiceProxy(基于标准Cookie)，通过cookie记录很多辅助信息：uid,路由策略,请求链初始时间等

初始化需要很多额外参数(其中，key参数，允许有两个，逗号分割，验签的时候，两个key都会试，但生成签名用的是第一个)，, _(*14)

同时提供下面两个方法：, _(*15)

• public function getTimestampStart() 获取整个请求链最初的时间
• public function getRequestSN() 获取初始化时得到（或生成）的请求的唯一SN

curl 提供了 getAddons() 获取指定的Addons, _(*16)

其他

关于资源释放：, _(*17)

curl->freeAddons(false) 释放掉所有addons的disposables数据, _(*18)

curl->freeAddons(true) 连同addons一起，全部释放掉, _(*19)