【微信 JS-SDK开发实战】好友分享开发

大家好，欢迎来到IT知识分享网。

文章目录

前言

纪录一个微信页面好友分享的开发过程，从 API 文档开始，到后端签名算法的实现，再到最终的效果呈现，开发过程中遇到的 BUG，做一次完整的纪录。

一、官方文档

一切的开始从官方文档开始，321 上链接：

https://developers.weixin..com/doc/offiaccount/OA_Web_Apps/JS-SDK.html#10

二、使用基本步骤

总而言之分为 5 个步骤，官档已经很描述的非常清晰，动手能力强的小伙伴们可以先退下了～😄

下面是实施的过程：

1.绑定域名

在公众号后台完成域名设置

2.引入JS文件

    <script src="https://res.wx..com/open/js/jweixin-1.6.0.js"></script> 

3.通过config接口注入权限验证配置

• 这里用的是 Ajax 请求配置（记得关闭异步）；
• 要传当前页面的 url（不然签名会失败）；
• wx.config 配置好相关参数；
• jsApiList根据自己需要配置就好；

 var config; // 获取当前页面的 url var url = window.location.href; // 通过请求方式获取签名 $.ajax({ type: 'GET', url: 'https://mjjz.gde3f.com/api/weixin?url=' + url, async:false, // data: $(obj).serialize(), // dataType: "json", success: function (ret) { let s1 = ret.split('(')[1].split(')')[0] config = JSON.parse(s1) } }) console.log(config) wx.config({ debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印。 appId: config.appId, // 必填，公众号的唯一标识 timestamp: config.timestamp, // 必填，生成签名的时间戳 nonceStr: config.nonceStr, // 必填，生成签名的随机串 signature: config.signature,// 必填，签名 jsApiList: [ 'updateAppMessageShareData',//分享到朋友圈 'updateTimelineShareData',//分享给好友 ] // 必填，需要使用的JS接口列表 });

4、通过ready接口处理成功验证

• 设置好标题、描述、图片、跳转链接
• 跳转链接一定是公众号后台设置好的可信域名！

          // 配置自定义分享内容
        wx.ready(function () {   //需在用户可能点击分享按钮前就先调用
            const shareData = { 
                title: '微信分享测试', // 分享标题
                desc: '2024/8/18-21 东莞厚街·广东现代国际展览中心', // 分享描述
                link: 'https://mjjz.gde3f.com/html/M52/dist/#/wxshare', // 分享链接，该链接域名或路径必须与当前页面对应的公众号JS安全域名一致
                imgUrl: 'https://mjjz.gde3f.com/html/M52/wx_logo2.png', // 分享图标
                success: function () {
                  // 设置成功
    		        console.log(666)
                }
            }
          wx.updateAppMessageShareData(shareData);
          wx.updateTimelineShareData(shareData);
        });

tips:调试用微信开发者工具—公众号网页项目

到目前为止，可以实现的效果，不报错就证明成功了 80%了；

5、后端签名算法（PHP）

只作参考，跟对接企微的 sdk 一毛一样，不再赘述了。

<?php $url = $_GET['url']; class JSSDK { private $appId; private $appSecret; private $url; public function __construct($appId, $appSecret,$url) { $this->appId = $appId; $this->appSecret = $appSecret; $this->url = $url; } public function getSignPackage() { $jsapiTicket = $this->getJsApiTicket(); $protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off' || $_SERVER['SERVER_PORT'] == 443) ? "https://" : "http://"; // $url = "$protocol$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]"; $url =$this->url; $timestamp = time(); $nonceStr = $this->createNonceStr(); // 这里参数的顺序要按照 key 值 ASCII 码升序排序 $string = "jsapi_ticket=$jsapiTicket&noncestr=$nonceStr&timestamp=$timestamp&url=$url"; $signature = sha1($string); $signPackage = array( "appId" => $this->appId, "nonceStr" => $nonceStr, "timestamp" => $timestamp, "url" => $url, "signature" => $signature, "rawString" => $string ); return $signPackage; } private function createNonceStr($length = 16) { $chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0"; $str = ""; for ($i = 0; $i < $length; $i++) { $str .= substr($chars, mt_rand(0, strlen($chars) - 1), 1); } return $str; } private function getJsApiTicket() { // jsapi_ticket 应该全局存储与更新，以下代码以写入到文件中做示例 $data = json_decode(file_get_contents("jsapi_ticket.json")); if ($data->expire_time < time() || empty($data)) { $accessToken = $this->getAccessToken(); // 如果是企业号用以下 URL 获取 ticket // $url = "https://qyapi.weixin..com/cgi-bin/get_jsapi_ticket?access_token=$accessToken"; $url = "https://api.weixin..com/cgi-bin/ticket/getticket?type=jsapi&access_token=$accessToken"; $res = json_decode($this->httpGet($url)); $ticket = $res->ticket; // P($res);exit; if ($ticket) { $data->expire_time = time() + 7000; $data->jsapi_ticket = $ticket; $fp = fopen("jsapi_ticket.json", "w"); fwrite($fp, json_encode($data)); fclose($fp); } } else { $ticket = $data->jsapi_ticket; } return $ticket; } private function getAccessToken() { // access_token 应该全局存储与更新，以下代码以写入到文件中做示例 $data = json_decode(file_get_contents("access_token.json")); if ($data->expire_time < time() || empty($data)) { // 如果是企业号用以下URL获取access_token // $url = "https://qyapi.weixin..com/cgi-bin/gettoken?corpid=$this->appId&corpsecret=$this->appSecret"; $url = "https://api.weixin..com/cgi-bin/token?grant_type=client_credential&appid=$this->appId&secret=$this->appSecret"; $res = json_decode($this->httpGet($url)); $access_token = $res->access_token; // P($res);exit; if ($access_token) { $data->expire_time = time() + 7000; $data->access_token = $access_token; $fp = fopen("access_token.json", "w"); fwrite($fp, json_encode($data)); fclose($fp); } } else { $access_token = $data->access_token; } return $access_token; } private function httpGet($url) { $curl = curl_init(); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_TIMEOUT, 500); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false); curl_setopt($curl, CURLOPT_URL, $url); $res = curl_exec($curl); curl_close($curl); return $res; } } $this->appid = get_config('wx_appid'); $this->secret = get_config('wx_secret'); if($this->appid == '' || $this->secret == ''){ showmsg('请先配置微信AppID和AppSecret！', U('config/index')); } $jssdk = new JSSDK($this->appid, $this->secret,$_GET['url']);//按照自己的公众号填写 $signPackage = $jssdk->GetSignPackage(); $tmp=json_encode(array ('appId'=>$signPackage["appId"],'timestamp'=>$signPackage["timestamp"],'nonceStr'=>$signPackage["nonceStr"],'signature'=>$signPackage["signature"],'url'=>$signPackage["url"])); $callback = $_GET['callback']; echo $callback.'('.$tmp.')'; exit; ?>

6、实际使用

这点稍微注意一下，把做好的链接生成二维码

扫码分享给好友，效果：

总结

以上就是实现微信好友分享的全过程，欢迎大家查漏补缺。