一个很简单实用 的 swoole 框架 麻雀虽小, 五脏俱全.rar

# Saber [](https://github.com/swlib/saber/releases) [](https://travis-ci.org/swlib/saber) [](https://secure.php.net/) [](https://github.com/swoole/swoole-src) [](https://github.com/swlib/saber/blob/master/LICENSE) ## 简介 HTTP军刀(呆毛王), `Swoole人性化组件库`之PHP高性能HTTP客户端, 基于Swoole原生协程, 支持多种风格操作, 底层提供高性能解决方案, 让开发者专注于功能开发, 从传统同步阻塞且配置繁琐的Curl中解放. > **[English Document](./README-EN.md)** - 基于Swoole协程Client开发 - 人性化使用风格, ajax.js/axios.js/requests.py用户福音, 同时支持PSR风格操作 - 浏览器级别完备的Cookie管理机制, 完美适配爬虫/API代理应用 - 请求/响应/异常拦截器 - 多请求并发, 并发重定向优化 - 连接池, 自动化复用长连接 - 通道池(Chan): 最大连接数限制+无阻塞 - HTTPS连接, CA证书自动化支持 - HTTP/Socks5 Proxy支持 - WebSocket连接支持 - 毫秒级超时定时器 - 自动化 编码请求/解析响应 数据 - 响应报文自动编码转换 - 异步超大文件上传/下载, 断点重传 - 自动重试机制 - 单次并发数控制 - 多模式/超细粒度异常处理机制 - (=)浏览器级别缓存机制 - (=)随机UA生成器 ------ <br> ## 安装 最好的安装方法是通过 [Composer](http://getcomposer.org/) 包管理器 : ```shell composer require swlib/saber ``` ------ ## 依赖 - **PHP71** or later - Swoole 2.1.2 or later - **Swoole 4 is the best** ------ <br> ## 协程调度 Swoole底层实现协程调度, **业务层无需感知**, 开发者可以无感知的**用同步的代码编写方式达到异步IO的效果和超高性能**，避免了传统异步回调所带来的离散的代码逻辑和陷入多层回调中导致代码无法维护. 需要在`onRequet`, `onReceive`, `onConnect`等事件回调函数中使用, 或是使用go关键字包裹 (`swoole.use_shortname`默认开启). ```php go(function () { echo SaberGM::get('http://httpbin.org/get'); }) ``` ------ ## 目录 - <a href="#例子">例子</a> - <a href="#静态方法">静态方法</a> - <a href="#生成实例">生成实例</a> - <a href="#生成会话">生成会话</a> - <a href="#并发请求">并发请求</a> - <a href="#数据解析">数据解析</a> - <a href="#网络代理">网络代理</a> - <a href="#文件上传">文件上传</a> - <a href="#超大文件下载">超大文件下载</a> - <a href="#自动重试">自动重试</a> - <a href="#缓存机制">缓存机制</a> - <a href="#psr风格">PSR风格</a> - <a href="#websocket">WebSocket</a> - <a href="#极限压力测试">极限压力测试</a> - <a href="#列式请求集">列式请求集</a> - <a href="#单次并发控制">单次并发控制</a> - <a href="#高性能无极限协程连接池">高性能无极限协程连接池</a> - <a href="#无限连接池">无限连接池</a> - <a href="#定容连接池">定容连接池</a> - <a href="#动态变容">动态变容</a> - <a href="#注意事项">注意事项</a> - <a href="#注册你所希望的配置">注册你所希望的配置</a> - <a href="#注意在一次性脚本中释放连接池">注意在一次性脚本中释放连接池</a> - <a href="#配置参数表">配置参数表</a> - <a href="#配置参数别名">配置参数别名</a> - <a href="#拦截器">拦截器</a> - <a href="#cookies">Cookies</a> - <a href="#属性">属性</a> - <a href="#任意格式互转">任意格式互转</a> - <a href="#域名路径和过期时限校验">域名路径和过期时限校验</a> - <a href="#持久化存储">持久化存储</a> - <a href="#异常机制">异常机制</a> - <a href="#捕获例子">捕获例子</a> - <a href="#异常报告级别控制">异常报告级别控制</a> - <a href="#掩码表">掩码表</a> - <a href="#异常自定义处理函数">异常自定义处理函数</a> - <a href="#road-map">Road Map</a> - <a href="#why-not-http2-?">Why not Http2 ?</a> - <a href="#ide-helper">IDE Helper</a> - <a href="#重中之重">重中之重</a> - <a href="#附录">附录</a> - <a href="#saber-api">Saber API</a> - <a href="#swlibsabergm">Swlib\SaberGM</a> - <a href="#swlibsaber">Swlib\Saber</a> - <a href="#swlibsaberrequest">Swlib\Saber\Request</a> - <a href="#swlibsaberresponse">Swlib\Saber\Response</a> - <a href="#swlibsaberrequestqueue">Swlib\Saber\RequestQueue</a> - <a href="#swlibsaberresponsemap">Swlib\Saber\ResponseMap</a> - <a href="#swlibsaberwebsocket">Swlib\Saber\WebSocket</a> - <a href="#swlibsaberwebsocketframe">Swlib\Saber\WebSocketFrame</a> ------ ## 例子 ### 静态方法 > 数据自动打包: 传入的data会自动转换成content-type所指定的类型格式 > > 默认为`x-www-form-urlencoded`, 也支持`json`等其它格式 `SaberGM ` := `Saber Global Manager`, 如果觉得类名有点长, 可以使用`class_alias`自己取别名, 推荐服务中使用**生成实例**的方式使用, 而把`SaberGM`作为快捷方式. ```php SaberGM::get('http://httpbin.org/get'); SaberGM::delete('http://httpbin.org/delete'); SaberGM::post('http://httpbin.org/post', ['foo' => 'bar']); SaberGM::put('http://httpbin.org/put', ['foo' => 'bar']); SaberGM::patch('http://httpbin.org/patch', ['foo' => 'bar']); ``` ### 生成实例 适用API代理服务 ```php $saber = Saber::create([ 'base_uri' => 'http://httpbin.org', 'headers' => [ 'Accept-Language' => 'en,zh-CN;q=0.9,zh;q=0.8', 'Content-Type' => ContentType::JSON, 'DNT' => '1', 'User-Agent' => null ] ]); echo $saber->get('/get'); echo $saber->delete('/delete'); echo $saber->post('/post', ['foo' => 'bar']); echo $saber->patch('/patch', ['foo' => 'bar']); echo $saber->put('/put', ['foo' => 'bar']); ``` ### 生成会话 Session会自动保存cookie信息, 其实现是[**浏览器级别完备**](#cookies)的 ```php $session = Saber::session([ 'base_uri' => 'http://httpbin.org', 'redirect' => 0 ]); $session->get('/cookies/set?foo=bar&k=v&apple=banana'); $session->get('/cookies/delete?k'); echo $session->get('/cookies')->body; ``` ### 并发请求 注意: 此处使用了并发重定向优化方案, 多个重定向总是依旧并发的而不会退化为队列的单个请求 ```php $responses = SaberGM::requests([ ['uri' => 'http://github.com/'], ['uri' => 'http://github.com/'], ['uri' => 'https://github.com/'] ]); echo "multi-requests [ {$responses->success_num} ok, {$responses->error_num} error ]:\n" ."consuming-time: {$responses->time}s\n"; // multi-requests [ 3 ok, 0 error ]: // consuming-time: 0.79090881347656s ``` ```php // 别名机制可以省略参数书写参数名 $saber = Saber::create(['base_uri' => 'http://httpbin.org']); echo $saber->requests([ ['get','/get'], ['post','/post'], ['patch','/patch'], ['put','/put'], ['delete','/delete'] ]); ``` ### 数据解析 目前支持`json`,`xml`,`html`,`url-query`四种格式的数据快速解析 ```php [$json, $xml, $html] = SaberGM::list([ 'uri' => [ 'http://httpbin.org/get', 'http://www.w3school.com.cn/example/xmle/note.xml', 'http://httpbin.org/html' ] ]); var_dump($json->getParsedJson()); var_dump($json->getParsedJsonObject()); var_dump($xml->getParsedXml()); var_dump($html->getParsedHtml()->getElementsByTagName('h1')->item(0)->textContent); ``` ### 网络代理 支持HTTP�