PHP调微信小程序接口:生成永久有效,数量暂无限制的小程序码

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_pathenv_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
    在这里插入图片描述

五、需要注意的坑

  • 需要注意生成二维码的两个参数 scenepath(新手必看、必踩的坑)
scene最大32个可见字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符请自行编码为合法字符(因不支持%,中文无法使用 urlencode 处理,请使用其他编码方式)
page页面 page,例如 pages/index/index,根路径前不要填加 /,不能携带参数(参数请放在 scene 字段里),如果不填写这个字段,默认跳主页面
  • 如果想要在测试版测试,请看第四步,需修改参数:
    • check_pathfalse
    • env_version 为 :体验版- trial 或 开发版- develop(release 为正式版)

六、小程序获取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 对应的值就需要自己对字符串做处理了。

谢谢阅读!!!
  • 1
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值