520 的 日子里当然是写博客啦啦啦 - - -

520 得 日子里当然是写博客哈哈哈！！！

520 地 日子里当然是写博客呜呜呜 ~ ~ ~

一、官方文档地址

• 【获取 AccessToken】导航：微信官方文档 --> 服务端 --> 接口调用凭证 --> getAccessToken
• 【生成永久有效，数量暂无限制的小程序码】微信官方文档 -> 小程序 -> 服务端 -> 小程序码 -> getUnlimited

二、我把这两篇合二为一了

• PHP调微信小程序接口生成access_token
• PHP调微信小程序接口：生成小程序码，常见问题

如果遇到了小程序的相关问题，可以看我这个分类下的博客：微信小程序

三、废话不多说，直接上代码

    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 为正式版）

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

谢谢阅读！！！