🔴Webman.tool 辅助函数百宝箱

v1.0.0 版本

2024-11-09 版本更新时间

1 安装

1 star

https://github.com/youfeed/webman.tool

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实例

推荐使用模型
laravel数据库
@param string $table 表名

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='')

赞助商

+成为赞助商

🔴Webman.tool 辅助函数百宝箱

Youloge.tool Webman 辅助函数百宝箱

项目地址

安装使用

使用说明

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

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

示例：请求微信证书

示例：上传JSON文件到七牛

示例：代理请求网网址

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

Mysql实例

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

Redis数组执行(自动close)

[webman-queue] 队列封装

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

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

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

安全的base64编码

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

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

七牛HMAC

* 七牛SIGN -

七牛AUTH -

七牛DOWN -

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

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

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

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

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

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

读取配置文件参数

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

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

示例：`请求微信证书`

示例：`上传JSON文件到七牛`

示例：`代理请求网网址`