🔴Webman.tool 辅助函数百宝箱

v1.0.0 版本
2024-11-09 版本更新时间
2 安装
5 star

Youloge.tool Webman 辅助函数百宝箱

使用前看一下下面辅助函数:尤其注意函数名称问题

  • 代码风格极简 欢迎提交代码
  • 几行代码就能接入微信支付/支付宝
  • 一行代码生成一个虚拟文件并上传

项目地址

Github Youloge.Tool Star我 有帮助的话,记得给个star 能提交点代码最好

  • 0.0.9 迁移多个辅助函数
  • 1.0.1 增加 构造腾讯云请求体

安装使用

composer require youloge/webman.tool

  • 如果要使用 onRequest 请求封装 请安装composer require workerman/http-client
  • 如果要使用 onQueue 队列封装 请安装composer require workerman/redis-queue

使用说明

  • 到目录config/youloge.php 新建配置文件
  • 工具箱已经内置``配置文件读取功能 .ini
    <?php
    $config = [
    'weixin'=>[
        'v3key'=>ini('WEIXIN.V3KEY',''),// 商户APIV3密钥,
        'anthor'=>'https://%s%S'
    ],
    // 支付宝 二类配置`public`和`gatway.xxx.xxx.xx`
    'alipay'=>[
        // 公共参数
        'public'=>[
            'app_id'=>'','method'=>'','version'=>'1.0',
            'format'=>'JSON','charset'=>'utf-8',
            'sign_type'=>'RSA2','timestamp'=>date('Y-m-d H:i:s')
        ]
        // 方法参数
        'alipay.system.oauth.token'=>['grant_type'=>'','code'=>""],
        'alipay.trade.create'=>['biz_content'=>'','notify_url'=>'',],
        'alipay.trade.precreate'=>['biz_content'=>'','notify_url'=>'',],
        'alipay.trade.page.pay'=>['notify_url'=>'','biz_content'=>''],
        'alipay.trade.wap.pay'=>['notify_url'=>'','biz_content'=>''],
    ],
    // 数组每次代理 随机选择一个
    'proxy'=>[
        ['addr'=>'','prot'=>'','pass'=>'']
    ],
    // 商户配置
    '150123456'=>[
        'apiclient_key'=>'file:///www/pem/150123456.apiclient_key.pem'
    ],
    // 小程序配置
    '12345678'=>[
        'secert'=>ini('XCX.SECERT','12345678'),
        'xxx'=>ini('XCX.xxx','12345678'),
    ]
    ];
    // 带格式的配置 - 例如
    $config['150123456']['cert'] = <<<EOT
    多行配置参数
    多行配置参数
    EOT;
    // 最后返回配置
    return $config;

示例代码 - 辅助辅助 函数还是要配合代码食用才香~

示例:腾讯云短信SMS号码查询

简单粗暴 不需要安装各种腾讯云各种SDK配好密钥 直接开干

    // 第二个参数为一个组合 `接入点/方法/版本/区域(可选参数)`
    $options = tencent_request('POST','sms.tencentcloudapi.com/DescribePhoneNumberInfo/2021-01-11/ap-nanjing',[
            'PhoneNumberSet'=>['+8617605509012']
        ],'1253985496');
    $request = onRequest(...$options); // 异步请求 
    $request = httpProxy(...$options); // 代理请求

示例:请求微信证书

就是这么简单 发起JSAPI H5 支付都是同理,比如JSAPI支付统一下单之后在调用一下签名组装一下payment参数即可支付

$options = weixin_request('GET','/v3/certificates',[],'商户ID');
@['data'=>$data] = $request = onRequest(...$options);
// 返回一个V3加密后的数组
$list = [];
foreach($data as ['serial_no'=>$serial_no,'encrypt_certificate'=>$encrypt_certificate]){
    // 使用微信V3解密 weixin_decrypt
    $certificate = weixin_decrypt($encrypt_certificate,'商户ID');
    // 按照证书序列号`PEM格式`保存到本地
    file_put_contents("$serial_no.pem",$certificate);
    $list[$serial_no] = $certificate;
}
// 
return $list;

示例:上传JSON文件到七牛

上传一个JSON片段文件并指定保存文件名到config/100.json, 二进制数据没测试*

     $url = qiniu_sign([
        'scope'=>"buket:100.json",
        'deadline'=>time()+300,
        'forceSaveKey'=>true,
        'saveKey'=>"config/100.json",
        'returnBody'=>'{"err": 200,"hash": $(etag)}',
        'insertOnly'=>0,
    ]);
    $data = json_encode([
        'uuid'=>100,
        'target'=>'https://www.abc.com',
        'type'=>'1'
    ]);
    $file = ['name'=>"100.json",'mime'=>'application/json','data'=>$data];
    @['err'=>$err,'hash'=>$hash] = $virtual = virtualFile("https://upload.qiniup.com/?token=$url",['file'=>$file],['key'=>'100']);

示例:代理请求网网址

网站支持github登录服务器在国内,运营商会屏蔽你的访问,这时候可以使用代理请求,数据结构与onRequest 一样

    @['appid'=>$appid,'code'=>$code] = $request->all();
    @['secret'=>$secret] = config("youloge.$appid"); // 配置参数格式统一起来
    // 换取`access_token`
    @['access_token'=>$access_token] = $data = `httpProxy`( 
    "https://github.com/login/oauth/access_token?client_id=$appid&client_secret=$secret&code=$code",[
      'headers'=>[
        'Accept'=>'application/json'
        ]
    ]);
    if($access_token == null){ return ['err'=>100800,'msg'=>'Github授权失败']; }
    // 获取用户信息
    @['email'=>$mail] = $data = httpProxy('https://api.github.com/user',[
      'headers'=>['Authorization'=>"Bearer $access_token",'Accept'=>'application/json','User-Agent'=>'Youloge-API']
    ]);
    if($mail == null){ return ['err'=>100801,'msg'=>'Github账户未认证']; }
    // 用登录信息 查询数据库 ...

代码工具箱


生成指定长度 - 用于验证码

  • 使用Base32字符集
  • @param int $len 长度
rand_base32($len=4)

Mysql实例

onMysql($table)

Redis实例 - 配置文件读取默认

  • 返回句柄
onRedis()

Redis数组执行(自动close)

  • runRedis('HGET',["wallet",$uuid])
  • runRedis('HINCRBY',["wallet",$uuid,10])
runRedis($method,$params)

[webman-queue] 队列封装

  • @param string $queue 队列名称
  • @param array $data 数据
  • @param int $delay 可选:延迟时间
     onQueue($queue,$data,$delay=0)

[http-client] 异步网络请求封装

  • @param string $url 请求网址
  • @param array $options 请求配置
  • 示例:'https://example.com/', ['method' => 'POST','version' => '1.1','headers' => ['Connection' => 'keep-alive'],'data' => ['key1' => 'value1', 'key2' => 'value2'],]
  • 请求返回 返回 [JOSN] 非对象返回 [raw=响应内容]
  • 错误返回 ['err'=>500,'msg'=>'错误信息']
     onRequest($url,$options=[])

网络代理 微信支付/支付宝 都需config/youloge.php 配置文件


HTTP代理网络请求 - 配置文件随机读取 [youloge.proxy[0~n]]

  • 请求参数与 httpProxy == onRequest == http-client(request) 一样
  • @param string $url 请求网址
  • @param array $options 请求配置
     httpProxy($url,$options=[])

生成虚拟文件对象并上传 - 支持多文件

  • @param string $url 上传地址
  • @param array $files 文件类型数据 ['表单名称'=>['name'=>'文件名称','mime'=>'文件类型','data'=>'数据内容']]
  • @param array $body 其他表单数据
  • @param array $header 其他表单请求头
  • @return array 上传结果
     virtualFile($url,$files,$body=[],$header=[])

  • =============================
  • = 算法相关
  • =============================

安全的base64编码

safe_base64_encode($data);
safe_base64_decode($data);

构造腾讯云请求体 - 配置路径(一律小写):[youloge.{appid}.secretid|secretkey]

  • 签名方法:TC3-HMAC-SHA256
  • @param string $method 请求方式 GET/POST
  • @param string $endpoint_action_version_region 接入点/方法/版本/区域
  • @param array $payload 请求载体 无参数时 设为[],null,false,0 即可
  • @param string $appid 选择那个appid下得的证书
   tencent_request($method,$endpoint_action_version_region,$payload,$appid)
   $method = POST
   // 接入点/方法/版本/区域(可选参数)
   trtc.tencentcloudapi.com/DescribeInstances/2019-07-22/ap-guangzhou

七牛签名 - 配置文件读取[youloge.qiniu.ak|sk]

七牛HMAC

  • @param string $string 待签名字符串
     qiniu_hmac($string)

* 七牛SIGN -

  • @param array $params 待签名数组对象
     qiniu_sign($params)

七牛AUTH -

  • @param array $params 待签名数组对象
     qiniu_auth($params)

七牛DOWN -

  • @param array $url 待签名下载网址
  • @param number $second 可选:设置有效时间 默认3600秒
  • @param string $attname 可选:设置下载文件名 默认没有
     qiniu_download($url,$second=3600,$attname='')

  • =============================
  • = 支付算法类 详细配置文件
  • = 证书路径 youloge.{$appid}.{apiclient_key}
  • = 证书格式 1. ./file.pem 文件路径 PEM编码的证书/私钥|公钥 2. PEM格式的私钥|公钥
  • =============================

私钥签名 - 配置路径:[youloge.{appid}.apiclient_key]

  • @param string $string 待签名字符串
  • @param string $appid 选择那个id下得的证书
  • 返回数组 成功 [err=>200,data=>base64] 失败 [err=>500,msg=>'签名错误']
     private_sign($string,$appid)

构造微信支付请求体 - 配置路径:[youloge.{appid}.apiclient_key|serial_no...]

  • 示例:weixin_request('GET','/v3/certificates',{},11111111);
  • 配置文件格式要规范
  • @param string $method 请求网络方式 GET/POST
  • @param string $router 请求网络路径 必须'/'开头
  • @param array $data JSON数据 不传设置为 '' false 0 即可
  • @param string $appid 选择那个商户id下得的证书
     weixin_request($method,$router,$data='',$appid='')

微信回调验签 - 配置路径:[youloge.{serial}.platform_cert]

  • @param object $request Request 给返回对象传进来
  • 成功返回 对象返回JSON 否则返回 []
  • 失败返回 ['err'=>500,'msg'=>Exception]
     weixin_verify($request)

微信解密V3 - 配置路径:[youloge.{appid}.v3key]

  • @param array $encrypt 解密数据 要有['ciphertext','nonce','associated_data']
  • @param string $appid 选择那个商户id下得的证书
  • 成功返回 对象返回JSON 否则返回 ['raw'=>$raw]
  • 失败返回 ['err'=>500,'msg'=>Exception]
     weixin_decrypt($encrypt,$appid)

构造支付宝支付请求体 - 配置路径:[appid.{appid}.apiclient_key]

  • 示例:alipay_request('alipay.trade.create',$data,11111111);
  • @param string $method 接口名称 alipay.trade.create ...
  • @param array $data 待合并参数
  • @param string $appid 选择那个商户id下得的证书
     alipay_request($method,$data,$appid)

支付宝验签 - 配置路径:[youloge.alipay.public_key]

  • @param object $request Request 给返回对象传进来
  • 成功返回 对象返回JSON 否则返回 []
  • 失败返回 ['err'=>500,'msg'=>Exception]
     alipay_verify($request)

读取配置文件参数

  • ini(null)返回全部配置
  • ini('MYSQL','默认值') 返回一级配置[数组]
  • ini('MYSQL.HOST') 返回三级配置[字符串]
ini($keys, $def='')
赞助商