文章目录
前言
一、官方文档
二、使用基本步骤
1.绑定域名
2.引入JS文件
3.通过config接口注入权限验证配置
4、通过ready接口处理成功验证
5、后端签名算法（PHP）
6、实际使用
总结
前言
纪录一个微信页面好友分享的开发过程，从 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×tamp=$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、实际使用
这点稍微注意一下，把做好的链接生成二维码
扫码分享给好友，效果：
总结
以上就是实现微信好友分享的全过程，欢迎大家查漏补缺。
