YurunHttp——PHP cURL 开源HTTP类库

宇润   ·  11月前   ·   后端语言

YurunHttp 是一个基于 PHP cURL 的开源HTTP类库,支持链式操作,省去繁杂的 cURL 使用方法,简单易用。

支持所有常见的GET、POST、PUT、DELETE、UPDATE等请求方式,支持设置和读取header、Cookie、请求参数、失败重试、限速、代理、证书等。

支持文件上传请求。

v2.0.0 & v1.3.17 更新内容:

新增支持get方法的参数自动作为get参数使用

新增上传文件支持直接传入文件内容,无需存在真实的文件

将命名空间从Yurun\Until\xxx 修正为 Yurun\Util\xxx (仅 2.0)

从此 v1.x 版本仅做 BUG 修复等维护工作,所有新功能都在 v2.x 上进行增加。

如何使用 YurunHttp:

Composer:"yurunsoft/yurun-http": "2.*"

在线技术文档:http://doc.yurunsoft.com/YurunHttp

Github:https://github.com/Yurunsoft/YurunHttp

码云:https://gitee.com/yurunsoft/YurunHttp

用法

链式调用

<?php
$http = HttpRequest::newSession();
$response = $http->retry(3) // 失败重试3次
                 ->ua('Mozilla/5.0 (compatible; Baiduspider/2.0; +http://www.baidu.com/search/spider.html)')
                 ->referer('http://www.baidu.com/')
                 ->accept('text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8')
                 ->acceptLanguage('zh-CN,zh;q=0.8')
                 ->get('http://www.baidu.com/');
if($response->success)
{
    $body = $response->body; // 返回的正文内容
    $header = $response->headers; // 返回头
}
else
{
    // 失败输出错误码和错误信息
    echo $response->errno(), ':', $response->error();
}

GET

<?php
$http = HttpRequest::newSession();
$response = $http->get('http://www.baidu.com/');
var_dump($response);

POST(x-www-form-urlencoded)

<?php
$requestBody = array(
    'lang' => 'php',
    'ver'  => 'any'
);
$http = HttpRequest::newSession();
$response = $http->post('http://www.baidu.com/', $requestBody);
var_dump($response);

POST(raw)

<?php
$requestBody = <<<EOF
{
    'lang': 'php',
    'ver':  'any'
}
EOF;
$http = HttpRequest::newSession();
$http->contentType('application/json');
$response = $http->post('http://www.baidu.com/', $requestBody);
var_dump($response);

POST上传文件(multi_part)

<?php
$requestBody = new HttpRequestMultipartBody();
$requestBody->add('name', 'php');
$requestBody->addFile('file', '/path/to/aaa.txt', 'aaa.txt');
$requestBody->addFileContent('file2', '我是文件内容', 'fileName.txt');
$http = HttpRequest::newSession();
$response = $http->post('http://www.baidu.com/', $requestBody);
var_dump($response);

FTP下载

<?php
$url = 'ftp://用户名:密码@IP地址/文件路径';
$url = 'ftp://IP地址/文件路径';
$http = HttpRequest::newSession();
// $http->userPwd('用户名','密码'); // 除了在URL里,也可以用这种方式设置密码
$http->saveFile('./')->get($url); // 使用ftp服务器中的文件名保存到当前目录
$http->saveFile('./abc.txt')->get($url); // 指定文件名保存

文件下载

<?php
$http = HttpRequest::newSession();
$http->download('baidu.html', 'http://www.baidu.com');

断点续传分块下载

<?php
try{
	$download = new Download('http://tool.chinaz.com/ChinazSEOTool.zip');
	$download->blockSize = 1048576; // 每一块数据的大小,可以不设置,默认为1M
	// 绑定每一块数据下载完成事件
	$download->on('progressChanged', function($e){
		var_dump($e);
	});
	// 下载
	$download->download(__DIR__ . '/1.zip');
}catch(Exception $e)
{
	var_dump($e->getMessage());
}

编码转换

<?php
$http = Yurun\Util\HttpRequest::newSession();
var_dump($http->get('http://www.baidu.com/')->body('UTF-8', 'gb2312')); // utf-8转gb2312

格式化结果

支持jsonp、json、xml

<?php
$http = Yurun\Util\HttpRequest::newSession();
var_dump('jsonp:', $http->get('https://graph.qq.com/oauth2.0/token')->jsonp($assoc));
// 你也可以获取时候进行编码转换,如下代码:gb2312转utf-8
// var_dump('jsonp:', $http->get('https://graph.qq.com/oauth2.0/token')->jsonp($assoc, 'gb2312', 'utf-8'));

具体详见Demo


1 条回复   |  直到 11月前 | 532 次浏览

尤里2号 11月前 支持  0 | 反对  0

很好用的工具库

登录后才可发表内容