ThinkPHP5集成JS-SDK实现微信自定义分享功能

ThinkPHP5集成JS-SDK实现微信自定义分享功能

将链接分享给好友时能够自定义标题、简介和logo

一、准备工作

1、认证的公众号

不管是订阅号还是服务号,都需要是经过认证的,否者不支持微信分享功能。

953680-20171214122434920-582384924.jpg

2、绑定域名

登录微信公众平台,设置—公众号设置—功能设置里,填写『JS接口安全域名』。

填写的域名须通过ICP备案的验证,并将平台给的txt文件放到域名指向的web服务器之下。


2.png

3、获取开发者ID和开发者密码

登录微信公众平台,开发—基本配置,即可看到AppID和AppSecret(若没有需要开启)。

4、下载官方示例代码

可在http://demo.open.weixin.qq.com/jssdk/sample.zip下载包含php、java、nodejs以及python的示例代码,其中php文件夹包含如下文件:

3.jpg

二、正式开发

1、PHP部分

1)将下载的php示例代码中的access_token.php、jsapi_ticket.php和jssdk.php放入到tp5框架的第三方接口扩展目录下,路径为extend/org/wechat/文件。

4.png

2)将jssdk.php文件重命名为Jssdk.php文件,设置命名空间,因为tp路由的关系,需要加上私有属性path,并在构造函数中设置 

$this->path = __DIR__ . DS;

5.jpg

同时将get_php_file函数返回值中的$filename改为 

$this->path . $filename

 ,否则会报错。

6.png

3)在config.php文件中,将先前获得的AppID和AppSecret配置好。

4)在application/index/controller下新建Wechat.php文件,内容如下:

7.png

2、JS部分

1)引入JS文件

在需要调用JS接口的页面引入JS文件(支持https):

<script src="http://res.wx.qq.com/open/js/jweixin-1.2.0.js"></script>

2)调用JS接口

官方技术文档给了如下说明:

// 通过config接口注入权限验证配置
wx.config({
    debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
    appId: '',   // 必填,公众号的唯一标识
    timestamp: , // 必填,生成签名的时间戳
    nonceStr: '', // 必填,生成签名的随机串
    signature: '',// 必填,签名
    jsApiList: [] // 必填,需要使用的JS接口列表
});
// 通过ready接口处理成功验证
wx.ready(function(){
    // config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。
    // 对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
});

代码如下:

8.png

至此就完成微信分享功能的开发了。

三、问题及解决方法

在开发过程中先后遇到了两次invalid signature签名错误,一次是分享首页成功,但是分享二级页面失败;一次是分享过的页面再次分享时会失败。

官方技术文档给了如下说明:

确保你获取用来签名的url是动态获取的。
如果是html的静态页面在前端通过ajax将url传到后台签名,前端需要用js获取当前页面除去'#'hash部分的链接(可用location.href.split('#')[0]获取,而且需要encodeURIComponent),
因为页面一旦分享,微信客户端会在你的链接末尾加入其它参数,如果不是动态获取当前链接,将导致分享后的页面签名失败。

第一个问题是因为首页由控制器输出模板,对模板进行赋值。控制器生成的签名和首页一致,与二级页面却不一致,所以我采取ajax方法,将静态页面的url传给后台(PHP),这样生成的签名就一致了。

1)首先是改写Jssdk.php中的签名算法,因为生成签名的方法为:

public function getSignPackage() {
    $jsapiTicket = $this->getJsApiTicket();
 
    // 注意 URL 一定要动态获取,不能 hardcode.
    $protocol = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off' || $_SERVER['SERVER_PORT'] == 443) ? "https://"; : "http://";;
    $url = "$protocol$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]";
    $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;
}

其中,

$string = "jsapi_ticket=$jsapiTicket&noncestr=$nonceStr&timestamp=$timestamp&url=$url”;

这里的url要改成静态页面的url。

所以在Jssdk.php文件中增加私有属性url,并在构造函数中设置

$this->url = $url;

9.png

2)控制器中不再采用给模板赋值的方式,而是使用json_encode()函数中将签名返回给静态页面。

10.png

3)静态页面中用ajax获取wx.config配置所需的几个参数的值,可以这样做:

<script type="text/javascript">
    url = location.href.split('#')[0]; // 传给后台PHP
    $.ajax({
        type: "GET",
        url: "https://xxx.com/wechat/share?url="+url,
        dataType : "json",
        success: function(data) {
            // 先前分享部分的代码挪到这里来
        }
    });
</script>

在需要分享的静态页面中引入这段JS代码,即可成功分享所有页面。第一个问题就解决了~

第二个问题更简单,官方技术文档已经说得很清楚了,js获取当前页面的链接可用location.href.split('#')[0]获取,而且需要encodeURIComponent,因为页面一旦分享,微信客户端会在你的链接末尾加入其它参数。

果然,因为我没encodeURIComponent,所以再次分享时链接为https://xxx.com/index.html?from=singlemessage&isappinstalled=0

12.jpg

url中form参数内容是微信自动为分享链接添加的参数,目的是为了记录分享来源。

from=singlemessage&isappinstalled=0表示来自好友分享
from=timeline&isappinstalled=0表示来自朋友圈分享
from=groupmessage&isappinstalled=0表示来自微信群分享

只要在上述JS代码中加上encodeURIComponent这句代码即可。如下所示:

url = location.href.split('#')[0];
url = encodeURIComponent(url);

完毕!


回复列表



回复操作

正在加载验证码......

请先拖动验证码到相应位置