520 的 日子里当然是写博客啦啦啦 - - -
520 得 日子里当然是写博客哈哈哈!!!
520 地 日子里当然是写博客呜呜呜 ~ ~ ~
一、官方文档地址
- 【获取 AccessToken】导航:微信官方文档 --> 服务端 --> 接口调用凭证 --> getAccessToken
- 【生成永久有效,数量暂无限制的小程序码】微信官方文档 -> 小程序 -> 服务端 -> 小程序码 -> getUnlimited
二、我把这两篇合二为一了
如果遇到了小程序的相关问题,可以看我这个分类下的博客:微信小程序
三、废话不多说,直接上代码
public function test() {
$scene = 'uid=1;pid=2'; //小程序码带的参数
// $page = 'pages/index/index';
$page = ''; //扫码跳转的页面,默认跳首页
$url = self::getQrCode($scene, $page);
echo "小程序码地址是: {$url}";
<<<EOF
【存本项目时返回】小程序码地址是: public/uploads/20220520/6286f97212345.jpg
【存云储存时返回】小程序码地址是: https://resource.******.com/20220520/6286f97212345.jpg
EOF;
}
/**
* 获取小程序码
* @param string $scene 二维码地址带的参数:最大32个可见字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符请自行编码为合法字符(因不支持%,中文无法使用 urlencode 处理,请使用其他编码方式)
* @param string $page 扫码需要跳转的页面://必须是已经发布的小程序存在的页面(否则报错),例如 pages/index/index, 根路径前不要填加 /,不能携带参数(参数请放在scene字段里),如果不填写这个字段,默认跳主页面
* @param int $width 二维码的宽度,单位 px,最小 280px,最大 1280px
* @return bool|string
*/
public function getQrCode($scene, $page = '', $width = 200) {
$accessToken = self::getAccessToken();
$url = "https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token={$accessToken}";
$data = [
'scene' => $scene, //最大32个可见字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符请自行编码为合法字符(因不支持%,中文无法使用 urlencode 处理,请使用其他编码方式)
'page' => $page, //必须是已经发布的小程序存在的页面(否则报错),例如 pages/index/index, 根路径前不要填加 /,不能携带参数(参数请放在scene字段里),如果不填写这个字段,默认跳主页面
'width' => $width, //二维码的宽度,单位 px,最小 280px,最大 1280px
];
$result = self::curlPostJson($url, $data);
<<<EOF
result 正常时 返回普通字符串:����JFIF��C��C��\b"��\b \v���}!1AQa"q2���\b#B��R��$3br� %&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz������������
result 异常时 返回json字符串:{"errcode":41030,"errmsg":"invalid page rid: 6286f575-5efffc6c-********"}
EOF;
if (is_json($result)) { //result 异常时 返回json字符串
die("getwxacodeunlimit 接口异常:" . $result); //记录异常:这里改成自己项目里的格式:存日志然后return,还是直接抛出异常
}
$url = self::saveQrcode($result);
return $url;
}
/**
* 保存小程序码到本地,还是上传到阿里云,根据自己的实际情况
* @param string $imageBuffer 图片buffer
* @param bool $isCloud 是否存云储存,默认否
* @return mixed
*/
public function saveQrcode($imageBuffer, $isCloud = false) {
$date = date('Ymd'); //以年月日为文件夹名
$fileName = $date . '/' . uniqid() . '.jpg'; //创建后缀为 .jpg 的文件名
$absolutePath = Env::get('root_path') . 'public/uploads/' . $date;
$absolutePath = str_replace('\\','/', $absolutePath);
$relativeFile = 'public/uploads/' . $fileName; //相对文件路径
$absoluteFile = Env::get('root_path') . $relativeFile; //绝对文件路径
if (!is_dir($absolutePath)) {
mkdir($absolutePath,0777,true); //true:支持递归创建文件夹
chmod($absolutePath,0777);
}
file_put_contents($absoluteFile, $imageBuffer); //把文件存到项目中
//如果是上传云储存,则返回云储存路径,删除本地文件
if ($isCloud) {
ALYOss::upload($fileName, $absoluteFile); //把本地的绝对文件上传到阿里云oss
$url = "https://resource.****.com/" . $fileName;
unlink(str_replace('\\','/', $absoluteFile)); //如果上传了oss,可以删除本地文件
} else {
$url = $relativeFile; //不上传云储存,返回项目的相对路径
}
return $url;
}
/**
* 获取access_token
* @return string
*/
public function getAccessToken() {
//$appid,$secret 实际使用中可以从配置文件中读取
$appid = 'wxewrewrger*****'; //小程序唯一凭证,即 AppID
$secret = '612313dfefet*****'; //小程序唯一凭证密钥,即 AppSecret
$url = 'https://api.weixin.qq.com/cgi-bin/token';
$data = [
'grant_type' => 'client_credential', //填写 client_credential
'appid' => $appid, //小程序唯一凭证:AppID 16位16进制(字母小写)
'secret' => $secret //小程序唯一凭证:AppSecret 32位16进制(字母小写) => 类似于md5()
];
$apiUrl = self::getUrl($url, $data);
$apiResult = self::curlGet($apiUrl);
$result = json_decode($apiResult,true);
$accessToken = isset($result['access_token']) ? $result['access_token'] : '';
if (!$accessToken) {
die("access_token 接口异常:" . $apiResult); //记录异常:这里改成自己项目里的格式:存日志然后return,还是直接抛出异常
}
return $accessToken; //返回格式形如:58_jWlcuOEwwerxIuwcU7u**********
}
//url生成器
public function getUrl($apiUrl, $param = []){
$param = http_build_query($param);
return $apiUrl . '?' . $param;
}
//get 请求
public function curlGet($url, $header = []) {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPGET, true);
if ($header) {
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
}
curl_setopt($ch, CURLOPT_TIMEOUT, 30); //设置超时时间:30s
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); //忽略ssl检测
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); //1 或 TRUE 将curl_exec()获取的信息以字符串返回,而不是直接输出。-
curl_setopt($ch, CURLINFO_HEADER_OUT, true); //TRUE 时追踪句柄的请求字符串,从 PHP 5.1.3 开始可用。这个很关键,就是允许你查看请求header
$output = curl_exec($ch);
if (!$output) {
// echo "request $url fail:", (array)curl_error($ch); //记录日志
}
curl_close($ch);
// echo "request $url success:" . json_encode(array($url, $header, $output), true); //记录日志
return $output;
}
//json post请求
public function curlPostJson($url, $data, $header = []) {
$data = json_encode($data);
$ch = curl_init();
if (!empty($data)) {
curl_setopt($ch, CURLOPT_POST,true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
}
$header[]='Content-Type: application/json; charset=utf-8';
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); //为true,则会跟踪爬取重定向页面,否则,不会跟踪重定向页面
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_TIMEOUT, 30); //设置超时时间:30s
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); //忽略ssl检测
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); //1 或 TRUE 将curl_exec()获取的信息以字符串返回,而不是直接输出。-
curl_setopt($ch, CURLINFO_HEADER_OUT, true); //TRUE 时追踪句柄的请求字符串,从 PHP 5.1.3 开始可用。这个很关键,就是允许你查看请求header
curl_setopt($ch, CURLOPT_URL, $url);
$output = curl_exec($ch);
if (!$output) {
// echo "request $url fail:", (array)curl_error($ch); //记录日志
}
curl_close($ch);
// echo "request $url success:" . json_encode(array($url, $header, $output), true); //记录日志
return $output;
}
四、在 体验版/开发版 生成小程序码
- 接口
https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN
只要增加2个参数:check_path
,env_version
就行了,格式如下:
$data = [
'scene' => $scene, //最大32个可见字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符请自行编码为合法字符(因不支持%,中文无法使用 urlencode 处理,请使用其他编码方式)
'page' => $page, //必须是已经发布的小程序存在的页面(否则报错),例如 pages/index/index, 根路径前不要填加 /,不能携带参数(参数请放在scene字段里),如果不填写这个字段,默认跳主页面
'width' => $width, //二维码的宽度,单位 px,最小 280px,最大 1280px
'check_path' => false, //检查 page 是否存在,为 true 时 page 必须是已经发布的小程序存在的页面(否则报错);为 false 时允许小程序未发布或者 page 不存在, 但 page 有数量上限(60000个)请勿滥用
'env_version' => 'trial' //要打开的小程序版本。正式版为 release,体验版为 trial,开发版为 develop
];
- 【接口文档地址:生成永久有效,数量暂无限制的小程序码】微信官方文档 -> 小程序 -> 服务端 -> 小程序码 -> getUnlimited
五、需要注意的坑
- 需要注意生成二维码的两个参数
scene
和path
(新手必看、必踩的坑)
scene | 最大32个可见字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符请自行编码为合法字符(因不支持%,中文无法使用 urlencode 处理,请使用其他编码方式) |
page | 页面 page,例如 pages/index/index,根路径前不要填加 /,不能携带参数(参数请放在 scene 字段里),如果不填写这个字段,默认跳主页面 |
- 如果想要在测试版测试,
请看第四步
,需修改参数:- check_path 为
false
- env_version 为 :
体验版- trial 或 开发版- develop
(release 为正式版)
- check_path 为
六、小程序获取scene场景值参数
- 在小程序
onLoad
的时候 需要使用decodeURIComponent
获取到生成二维码时传入的scene 值
Page({
onLoad (options) {
// scene 需使用 decodeURIComponent 才能获取到生成的小程序码传入的 scene(场景值)
if (options.scene) { //scene场景值不存在时:options.scene 为 undefined
const scene = decodeURIComponent(options.scene)
}
}
})
需要注意的是:如果你传递的 scene 参数是
uid=1&pid=9
,那么在 encodeURIComponent 出来后的结果也是uid=1&pid=9
,获取 uid,pid 对应的值就需要自己对字符串做处理了。