README

安装

"require" : {
    "php" : ">=5.4.0",
    "leaps/httpclient": "1.4.9"
}

如果您修改了leaps/httpclient的代码，我非常欢迎您将您的修改提交给我。如果在使用过程中遇到任何问题，请通过右侧的issues提交给我，我将尽快修复。本项目的更新非常频繁，1.2和1.3版本除响应类不兼容外，基本都兼容。如果您使用的是1.2版本并希望升级到1.3版本，只需继续使用1.2的响应类即可。QQ交流群：136057107

基本使用

此组件非常易于使用：

<?php
//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$response = $HttpClient->get('http://www.baidu.com/');
echo $response->getContent();

也可以批量获取不同网页的内容：

<?php
//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$responses = $HttpClient->get(['http://www.baidu.com/','http://www.qq.com']);
foreach($responses as $response){
    echo $response->getContent();
}

设置User Agent

默认情况下，如果是WEB形式使用本组件，UserAgent将取用户浏览器的值，在CLI模式下该值是PHP版本号。

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$HttpClient->setUserAgent('test')；
$response = $HttpClient->get('http://www.baidu.com/');
echo $response->getContent();

设置cookie内容，$cookie为字符串，多个cookie请用分号隔开

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
//$HttpClient->setCookie(['a'=>'3']);
$HttpClient->setCookie('a=1;b=a;c[0]=1;c[1]=2');
$response = $HttpClient->get('http://www.baidu.com/');
echo $response->getContent();

设置代理服务器地址

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$HttpClient->setHttpProxy('host','port');
$response = $HttpClient->get('http://www.baidu.com/');
echo $response->getContent();

设置基本认证的用户名和密码

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$HttpClient->setAuthorization('username','password');
$response = $HttpClient->get('http://www.baidu.com/');
echo $response->getContent();

设置引用页

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$HttpClient->setReferer('http://www.test.com/');
$response = $HttpClient->get('http://www.baidu.com/');
echo $response->getContent();

设置请求的服务器的IP，这样可以避免请求域名时DNS解析

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
// 这样设置请求页面并不会通过DNS解析获取百度服务器的数据，而是直接请求127.0.0.1（即本机）的服务器的数据
$HttpClient->setHostIp('127.0.0.1');
$response = $HttpClient->get('http://www.baidu.com/');
echo $response->getContent();

设置并发请求时最大队列数量，系统默认为100。

HttpClient支持并发请求，详细请查看下面的get()方法。如果同时请求一个服务器，在短时间内会对被请求服务器造成巨大压力，也会对本服务器增加网络IO压力，因此这个参数可以控制同时并发的数量上限。当达到上限后，队列将等待执行完毕后再追加一个插入队列。

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$HttpClient->setMultiMaxNum(100);
$response = $HttpClient->get(['http://www.baidu.com/']);
echo $response->getContent();

设置其他参数

用于弥补HttpClient类中不存在的方法，具体请查看具体驱动的方法，例如使用CURL时，其实相当于CURL的setOption()方法

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$HttpClient->setOption(CURLOPT_TIMEOUT,30);
$response = $HttpClient->get('http://www.baidu.com/');
echo $response->getContent();

get请求

使用GET方法请求一个（或多个）页面，这样可以大大缩短API请求时间，并可以设置超时时间，单位：秒。支持并发进程请求。并发请求的特点：例如需要同时请求100个页面，传统的方法是一个一个载入，假设每个页面需要0.1秒，那么100个页面就需要耗时10秒。而通过并发的方式，100个页面理论上只需要0.1秒就可以同时完成加载，效率非常高。

单个URL直接返回请求的内容对象，多个URL则返回以URL为键的数组

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
// 请求单个页面
echo $HttpClient->get('http://www.baidu.com/',3)->getContent();

// 请求多个页面
$urls = array
(
    'http://www.baidu.com/',
    'http://www.google.com/',
    'http://www.sina.com.cn/test.html',
);
// 返回已url为key的数组，注意，前后顺序有可能跟$urls中的不一样
print_r($HttpClient->get($urls));

post请求

使用POST方法提交数据，支持多个页面同时请求 // 请求单个页面

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$HttpClient->post('http://www.baidu.com/',array('a'=>1,'b'=>1));

// 请求多个页面
$urls = array
(
    'http://www.baidu.com/',
    'http://www.google.com/',
);
$vars = array
(
    array('a'=>1,'b'=>1),   //对应 http://www.baidu.com/
    array('c'=>1,'d'=>1),   //对应 http://www.google.com/
);
print_r($HttpClient->post($urls,$vars));

put请求

使用PUT方法提交数据，支持多个页面同时请求 // 请求单个页面

//Create an instance
$HttpClient = new \Leaps\HttpClient\Adapter\Curl();
$HttpClient->put('http://www.baidu.com/',array('a'=>1,'b'=>1));

// 请求多个页面
$urls = array
(
    'http://www.baidu.com/',
    'http://www.google.com/',
);
$vars = array
(
    array('a'=>1,'b'=>1),   //对应 http://www.baidu.com/
    array('c'=>1,'d'=>1),   //对应 http://www.google.com/
);
print_r($HttpClient->put($urls,$vars));

delete请求

使用DELETE方法请求一个（或多个）页面，这样可以大大缩短API请求时间，并可以设置超时时间，单位：秒。支持并发进程请求，并发请求的特点：例如需要同时请求100个页面，传统的方法是一个一个载入，假设每个页面需要0.1秒，那么100个页面就需要耗时10秒。而通过并发的方式，100个页面理论上只需要0.1秒就可以同时完成加载，效率非常高。