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

文章目录

前言

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

一、官方文档

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

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

二、使用基本步骤

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

下面是实施的过程：

1.绑定域名

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

2.引入JS文件

    <script src="https://res.wx.qq.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 = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
    $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.qq.com/cgi-bin/get_jsapi_ticket?access_token=$accessToken";
      $url = "https://api.weixin.qq.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.qq.com/cgi-bin/gettoken?corpid=$this->appId&corpsecret=$this->appSecret";
      $url = "https://api.weixin.qq.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、实际使用

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

扫码分享给好友，效果：

总结

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