Curl PHP v1.0

一个小巧方便快捷的 PHP CURL 库，可以用它进行网页内容的抓取，文件的下载，API接口的通信等操作，总之它是方便的，快捷的。除此之外，它还具备多线程能力。

curl静态属性

以下属性仅适用于$curl->get()方法的第一个参数，如果curl线程为下载文件线程，curl::head 和 curl::body 是无效的

• curl::head 取出header部分的内容
• curl::body 取出body部分的内容
• curl::info 取出curl反馈的信息
• curl::file 取出下载的文件信息 仅对启用了下载的线程有效
• curl::isDown 是否是一个下载线程
• curl::error 取出curl的报错信息

curl动态属性

• $curl->threadNames 取出所有线程的名称

curl方法

• $curl->__construct($default = array())
• $curl->add($copyName = false) 添加线程
• $curl->run($name = null) 执行curl
• $curl->runSmall($url, $method = 'get', $ssl = 1) 快速的执行curl
• $curl->get($flag = self::body, $name = null) 取出执行结果
• $curl->getAll() 取出所有执行结果
• $curl->getManager($name) 处理抓取结果的回调类

curl::head

取出目标站点响应的header标头

$curl = new curl();

$curl->add()->opt_targetURL('http://php.net')->done();

$curl->run();

echo $curl->get(curl::head);

curl::body

取出目标站点响应的body主体内容

$curl = new curl();

$curl->add()->opt_targetURL('http://php.net')->done();

$curl->run();

echo $curl->get(curl::body);

curl::info

取出curl反馈的信息

$curl = new curl();

$curl->add()->opt_targetURL('http://php.net')->done();

$curl->run();

print_r($curl->get(curl::info));

curl::file

取出下载的文件信息 仅对启用了下载的线程有效 开启php_fileinfo扩展可返回文件的mime类型

$curl = new curl();

$curl->add()
  ->opt_targetURL('http://php.net')
  ->opt_download('php.html')
  ->done();
  
$curl->run();

print_r($curl->get(curl::file));

curl::isDown

是否是一个下载线程

$curl = new curl();

$curl->add()
  ->opt_targetURL('http://php.net')
  ->opt_download('php.html')
  ->done();
$curl->run();
var_dump($curl->get(curl::isDown)); // true

$curl->add()->opt_targetURL('http://php.net')->done();
$curl->run();
var_dump($curl->get(curl::isDown)); // false

curl::error

取出错误信息

$curl = new curl();

$curl->add()->opt_targetURL('http://php.net')->done();

$curl->run();

print_r($curl->get(curl::error));

$curl->threadNames

取出所有线程的名称

$curl = new curl();

$curl->add()->opt_targetURL('http://php.net')->done('get', 'a');
$curl->add()->opt_targetURL('https://www.baidu.com', 2)->done('get','b');
$curl->add()->opt_targetURL('http://image.baidu.com/')->done('get','c');
$curl->add()->opt_targetURL('https://zhidao.baidu.com/',2)->done('get','d');

/*
run之前的结果 array()
*/
print_r($curl->threadNames);

$curl->run();

/*
run之后的结果 array(
  0 => a
  1 => b
  2 => c
  3 => d
)
*/
print_r($curl->threadNames);

$curl->__construct($default = array())

• $default 规定curl的一些缺省值

$default = array(
  'timeOut' => array(
    'connectMaxTime' => 30,
    'execMaxTime' => 60
  ),
  'header' => array(
    'User-Agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36'
  )
);

$curl = new curl($default);

$curl->add()->opt_targetURL('http://php.net')->done();

$curl->run();

echo $curl->get(curl::body);

$curl->add($copyName = false)

添加一个抓取线程

• $copyName 复制线程 复制一个已有线程，提供已有线程的名称即可

该方法返回的是配置线程对象（curlThreadOptions）,该对象可通过$curl->add()进行使用 以下为配置线程对象中的可用外部方法

• $curlThreadOptions->opt_targetURL($url, $ssl = 1) 设置目标站点的url
• $curlThreadOptions->opt_isGetBody($is) 是否取回主体内容
• $curlThreadOptions->opt_isGetHead($is) 是否取回标头内容
• $curlThreadOptions->opt_download($savePath) 下载文件
• $curlThreadOptions->opt_proxy($ip, $port = '80', $username = '', $password = '', $socks5 = false) 使用代理访问目标站点
• $curlThreadOptions->opt_jump($max = 3) 自动跳转
• $curlThreadOptions->opt_timeOut($execMaxTime = 30, $connectMaxTime = 0) 请求超时设置
• $curlThreadOptions->opt_sendHeader($name, $value) 向目标站点发送的header数据
• $curlThreadOptions->opt_sendCookie($field, $value) 向目标站点发送的cookie数据
• $curlThreadOptions->opt_sendPost($field, $value = null) 向目标站点发送的post数据
• $curlThreadOptions->opt_sendPostCustom($data, $format = null) 向目标站点发送的自定义数据
• $curlThreadOptions->done($requestMethod = 'get', $name = null) 完成配置

$curl = new curl();

$curl->add()
  ->opt_targetURL('http://image5.tuku.cn/pic/dongwushijie/endearing_dog_181/098.jpg')
  ->opt_download('098.jpg')
  ->opt_timeOut(120, 10)
  ->opt_proxy('127.0.0.1:8080')
->done('get', 'a');

/*
 * 复制a线程给b线程
 * b线程中更改了opt_targetURL和opt_download配置，其它将继承a线程的所有配置信息，
 * 即b线程同a线程一样，最大链接时间为10秒，最大下载时间为120秒，且使用代理127.0.0.1:8080
 */
$curl->add('a')
  ->opt_targetURL('http://image5.tuku.cn/pic/dongwushijie/endearing_dog_181/099.jpg')
  ->opt_download('099.jpg')
->done('get', 'b');

$curl->run();

print_r($curl->get(curl::file));

$curl->run($name = null)

执行线程，如未指定$name(线程名称)，即执行所有线程，执行完毕后所有线程将被释放；如指定$name，即执行$name线程，执行完毕后$name线程会被释放，而没有被执行的线程不会被释放，如何释放，可通过$curl->free()进行释放。

$curl = new curl();

$cookies = array(
  'BIDUPSID' => '109CBB215F051223E78E0328F4586147',
  'PSTM' => '1486296197',
  '__cfduid' => 'd4b92399c102c843eee0176ecbbf5be8a1486296206',
  'BAIDUID' => '109CBB215F051223E78E0328F4586147:SL=0:NR=50:FG=1',
  'MCITY' => '-179%3A'
);

$thread = $curl->add()->opt_targetURL('https://www.baidu.com/', 2);
foreach ($cookies as $name=>$value) {
  $thread->opt_sendCookie($name, $value);
}
$thread->done('get', 'a');

// 复制a线程给b线程
$curl->add('a')
  ->opt_targetURL('https://www.baidu.com/s?wd=php', 2)
->done('get', 'b');

// a线程执行完毕即被释放
$curl->run('a');
echo $curl->get(curl::body);

// 复制失败 a线程已被释放 c线程不具有a线程的cookie
$curl->add('a')
  ->opt_targetURL('https://www.baidu.com/s?wd=php+curl', 2)
->done('get', 'c');

// 复制成功 b线程尚未被执行
$curl->add('b')
  ->opt_targetURL('https://www.baidu.com/s?wd=php+curl', 2)
->done('get', 'e');

$curl->runSmall($url, $method = 'get', $ssl = 1)

$curl->get($flag = self::body, $name = null)

$curl->getAll()

$curl->getManager($name)