CVE-2021-43678: GitHub - gaoming13/wechat-php-sdk: 微信公众平台php版开发包

wechat-php-sdk

微信公众平台php版开发包

• 支持消息加解密方式的明文模式、兼容模式、安全模式
• 支持自动接入微信公众平台（步骤）
• 支持php5.4+

相关参考

• 微信公众平台开发官方文档
• 微信公众平台接口测试帐号申请

功能模块

Wechat （处理自动接入、获取与回复微信消息）(使用说明)

• 接收普通消息/事件推送
• 被动回复（文本、图片、语音、视频、音乐、图文）
• 转发到多客服接口

Api （处理需要access_token的主动接口）(使用说明)

• 主送发送客服消息（文本、图片、语音、视频、音乐、图文）
• 多客服功能（客服管理、多客服回话控制、获取客服聊天记录等）
• 素材管理（临时素材、永久素材、素材统计）
• 自定义菜单管理（创建、查询、删除菜单）
• 微信JSSDK（生成微信JSSDK所需的配置信息）
• 账号管理（生成带参数的二维码、长链接转短链接接口）
• 用户管理（用户分组管理、设置用户备注名、获取用户基本信息、获取用户列表、网页授权获取用户基本信息）
• 微信公众号支付(JSAPI)
• 微信App支付(App)
• 微信硬件平台基础消息接口

DEMO

项目内 demo/demo_simple.php

require 'wechat-php-sdk/autoload.php’;

use Gaoming13\WechatPhpSdk\Wechat;

$wechat = new Wechat([ ‘appId’ => 'wx733d7f24bd29224a’, ‘token’ => 'gaoming13’, ‘encodingAESKey’ => ‘072vHYArTp33eFwznlSvTRvuyOTe5YME1vxSoyZbzaV’ ]);

// 获取消息 $msg = $wechat->serve();

// 回复消息 if ($msg[‘MsgType’] == ‘text’ && $msg[‘Content’] == ‘你好’) { $wechat->reply(“你也好！”); } else { $wechat->reply(“听不懂！”); }

如何引入wechat-php-sdk

1. 手动引入

<?php require "wechat-php-sdk/autoload.php"; // 引入自动加载SDK类的方法

use Gaoming13\\WechatPhpSdk\\Wechat;
use Gaoming13\\WechatPhpSdk\\Api;
...

2. 使用 composer

#安装composer依赖 composer require “gaoming13/wechat-php-sdk:1.*” composer dump-autoload --optimize

require "vendor/autoload.php"; use Gaoming13\WechatPhpSdk\Wechat; use Gaoming13\WechatPhpSdk\Api;

3. ThinkPHP 内使用

将SDK内 src 文件夹重命名为 Gaoming13, 拷贝至 ThinkPHP/Library/ 下即可使用 Wechat 和 Api 类库.

Thinkphp控制器内使用SDK的DEMO:

具体代码见: 项目内 demo/demo_thinkPHP.php

$wechat = new \Gaoming13\WechatPhpSdk\Wechat([ ‘appId’ => $appId, ‘token’ => $token, ‘encodingAESKey’ => $encodingAESKey ]);

$api = new \Gaoming13\WechatPhpSdk\Api([ ‘appId’ => $appId, ‘appSecret’ => $appSecret, ‘get_access_token’ => function(){ // 用户需要自己实现access_token的返回 … }, ‘save_access_token’ => function($token) { // 用户需要自己实现access_token的保存 … }, ]);

接入微信公众平台开发方法

官方:接入概述

以项目中的 demo/demo_simple.php 为例

1. 进入自己微信公众平台 开发者中心, 进入修改服务器配置页面
2. URL填写demo_simple.php的访问地址, 比如http://wx.diary8.com/demo/demo_simple.php,确保外网可访问到
3. 填写Token和EncodingAESKey, 消息加解密方式可任意选择
4. 修改demo.php里配置项appId和token, appId为AppID(应用ID),token为第3部填写的token, 如果消息加解密方式选择了兼容模式或安全模式,还需要填写encodingAESKey
5. 提交服务器配置表单
6. ！！！ 注意成功后还需要启用服务器配置，不然不生效

Wechat：模块使用说明

$wechat = new Wechat([ // 开发者中心-配置项-AppID(应用ID) ‘appId’ => 'wx733d7f24bd29224a’, // 开发者中心-配置项-服务器配置-Token(令牌) ‘token’ => 'gaoming13’, // 开发者中心-配置项-服务器配置-EncodingAESKey(消息加解密密钥) // 可选: 消息加解密方式勾选 兼容模式 或 安全模式 需填写 ‘encodingAESKey’ => ‘072vHYArTp33eFwznlSvTRvuyOTe5YME1vxSoyZbzaV’ ]);

// 获取微信消息 $msg = $wechat->serve();

// 回复微信消息 if ($msg[‘MsgType’] == ‘text’ && $msg[‘Content’] == ‘你好’) { $wechat->reply(“你也好！”); } else { $wechat->reply(“听不懂！”); }

Wechat：接收普通消息/事件推送

接受到的普通消息与事件推送会原样以数组对象返回，具体每种消息结构请看:

官方:接收普通消息 官方:接收事件推送

Wechat：被动回复（文本、图片、语音、视频、音乐、图文）

官方:被动回复用户消息

回复文本消息

$wechat->reply(‘hello world!’); // 或者 $wechat->reply([ ‘type’ => 'text’, ‘content’ => ‘嘿嘿，呵呵~~’ ]);

回复图片消息

$wechat->reply([ ‘type’ => 'image’, // 通过素材管理接口上传多媒体文件，得到的id ‘media_id’ => ‘Uq7OczuEGEyUu–dYjg7seTm-EJTa0Zj7UDP9zUGNkVpjcEHhl7tU2Mv8mFRiLKC’ ]);

回复语音消息

$wechat->reply([ ‘type’ => 'voice’, // 通过素材管理接口上传多媒体文件，得到的id ‘media_id’ => ‘rVT43tfDwjh4p1BV2gJ5D7Zl2BswChO5L_llmlphLaTPytcGcguBAEJ1qK4cg4r_’ ]);

回复视频消息

$wechat->reply([ ‘type’ => 'video’, // 通过素材管理接口上传多媒体文件，得到的id ‘media_id’ => 'yV0l71NL0wtpRA8OMX0-dBRQsMVyt3fspPUzurIS3psi6eWOrb_WlEeO39jasoZ8’, ‘title’ => '视频消息的标题’, //可选 ‘description’ => ‘视频消息的描述’ //可选 ]);

回复音乐消息

$wechat->reply([ ‘type’ => 'music’, ‘title’ => '音乐标题’, //可选 ‘description’ => '音乐描述’, //可选 ‘music_url’ => 'http://me.diary8.com/data/music/2.mp3’, //可选 ‘hqmusic_url’ => 'http://me.diary8.com/data/music/2.mp3’, //可选 ‘thumb_media_id’ => 'O39wW0ZsXCb5VhFoCgibQs5PupFb6VZ2jH5A8gHUJCJz2Qmkrb7objoTue7bGTGQ’, ]);

回复图文消息

$wechat->reply([ ‘type’ => 'news’, ‘articles’ => [ [ ‘title’ => '图文消息标题1’, //可选 ‘description’ => '图文消息描述1’, //可选 ‘picurl’ => 'http://me.diary8.com/data/img/demo1.jpg’, //可选 ‘url’ => ‘http://www.example.com/’ //可选 ], [ ‘title’ => '图文消息标题2’, ‘description’ => '图文消息描述2’, ‘picurl’ => 'http://me.diary8.com/data/img/demo2.jpg’, ‘url’ => ‘http://www.example.com/’ ], [ ‘title’ => '图文消息标题3’, ‘description’ => '图文消息描述3’, ‘picurl’ => 'http://me.diary8.com/data/img/demo3.jpg’, ‘url’ => ‘http://www.example.com/’ ], ], ]);

Wechat：转发到多客服接口

$wechat->reply([ ‘type’ => 'transfer_customer_service’, ‘kf_account’ => ‘test1@test’ // 可选 ]);

Api：模块使用说明****access_token需要用户自己实现缓存

由于微信的access_token请求次数有限制，

用户需要自己实现access_token的获取和保存，

否则access_token每次都会被更新，请求限额很快就用完了.

$api = new Api([ ‘appId’ => $appId, ‘appSecret’ => $appSecret, ‘get_access_token’ => function() { // 用户需要在这里实现access_token的返回 … }, ‘save_access_token’ => function($token) { // 用户需要在这里实现access_token的保存 … } ]);

access_token可以保存在数据库、Memcached、xcache 等.

当同一个微信号被用于多个项目中，access_token需要全局维护.

以下DEMO使用了Memcached缓存access_token

具体代码见: demo/demo_message.php

use Gaoming13\WechatPhpSdk\Wechat; use Gaoming13\WechatPhpSdk\Api;

// AppID(应用ID) $appId = 'wx733d7f24bd29224a’; // AppSecret(应用密钥) $appSecret = 'c6de6zcw78522dddww8w42e403376a410e’; // Token(令牌) $token = 'gaoming13’; // EncodingAESKey(消息加解密密钥) $encodingAESKey = '072vHYArTp33eFwznlSvTRvuyOTe5YME1vxSoyZbzaV’;

// 这是使用了Memcached来保存access_token $m = new Memcached(); $m->addServer('localhost’, 11211);

// wechat模块 - 处理用户发送的消息和回复消息 $wechat = new Wechat([ ‘appId’ => $appId, ‘token’ => $token, ‘encodingAESKey’ => $encodingAESKey, ]);

// api模块 - 包含各种系统主动发起的功能 $api = new Api([ ‘appId’ => $appId, ‘appSecret’ => $appSecret, ‘get_access_token’ => function() use ($m) { // 用户需要自己实现access_token的返回 return $m->get(‘access_token’); }, ‘save_access_token’ => function($token) use ($m) { // 用户需要自己实现access_token的保存 $m->set('access_token’, $token, 0); }, ‘get_jsapi_ticket’ => function() use ($m) { // 可选：用户需要自己实现jsapi_ticket的返回（若使用get_jsapi_config，则必须定义） return $m->get(‘jsapi_ticket’); }, ‘save_jsapi_ticket’ => function($jsapi_ticket) use ($m) { // 可选：用户需要自己实现jsapi_ticket的保存（若使用get_jsapi_config，则必须定义） $m->set('jsapi_ticket’, $jsapi_ticket, 0); }, ]);

// 获取微信消息 $msg = $wechat->serve();

// 被动回复用户消息 $wechat->reply(‘这是我被动发送的消息！’);

// 主动发送文本消息 $api->send($msg[‘FromUserName’], ‘这是我主动发送的消息！’);

Api模块接口返回值格式

所有Api模块的接口返回值格式为: [$err, $data];

$err为错误信息, $data为正确处理返回的数据

可用list接收:

list($err, $kf_list) = $api->get_kf_list(); if (is_null($err)) { // 接口正确返回处理 } else { // 接口错误返回处理 }

发送模版消息

官方:模版消息

$api->message_template_send('接收者openid’, '模板ID’, '模版数据json’, ‘模板跳转链接’);

Api：发送客服消息（文本、图片、语音、视频、音乐、图文）

官方:客服消息

主动发送文本消息

$api->send($msg[‘FromUserName’], ‘heheh’); // 或者 $api->send($msg[‘FromUserName’], [ ‘type’ => 'text’, ‘content’ => 'hello world!’, ‘kf_account’ => ‘test1@kftest’ // 可选(指定某个客服发送, 会显示这个客服的头像) ]);

主动发送图片消息

$api->send($msg[‘FromUserName’], [ ‘type’ => 'image’, ‘media_id’ => 'Uq7OczuEGEyUu–dYjg7seTm-EJTa0Zj7UDP9zUGNkVpjcEHhl7tU2Mv8mFRiLKC’, ‘kf_account’ => ‘test1@kftest’ // 可选(指定某个客服发送, 会显示这个客服的头像) ]);

主动发送语音消息

$api->send($msg[‘FromUserName’], [ ‘type’ => 'voice’, ‘media_id’ => 'rVT43tfDwjh4p1BV2gJ5D7Zl2BswChO5L_llmlphLaTPytcGcguBAEJ1qK4cg4r_’, ‘kf_account’ => ‘test1@kftest’ // 可选(指定某个客服发送, 会显示这个客服的头像) ]);

主动发送视频消息

$api->send($msg[‘FromUserName’], [ ‘type’ => 'video’, ‘media_id’ => 'yV0l71NL0wtpRA8OMX0-dBRQsMVyt3fspPUzurIS3psi6eWOrb_WlEeO39jasoZ8’, ‘thumb_media_id’ => '7ct_DvuwZXIO9e9qbIf2ThkonUX_FzLAoqBrK-jzUboTYJX0ngOhbz6loS-wDvyZ’, // 可选(无效, 官方文档好像写错了) ‘title’ => '视频消息的标题’, // 可选 ‘description’ => '视频消息的描述’, // 可选, ‘kf_account’ => ‘test1@kftest’ // 可选(指定某个客服发送, 会显示这个客服的头像) ]);

主动发送音乐消息

$api->send($msg[‘FromUserName’], [ ‘type’ => 'music’, ‘title’ => '音乐标题’, // 可选 ‘description’ => '音乐描述’, // 可选 ‘music_url’ => 'http://me.diary8.com/data/music/2.mp3’, // 可选 ‘hqmusic_url’ => 'http://me.diary8.com/data/music/2.mp3’, // 可选 ‘thumb_media_id’ => 'O39wW0ZsXCb5VhFoCgibQs5PupFb6VZ2jH5A8gHUJCJz2Qmkrb7objoTue7bGTGQ’, ‘kf_account’ => ‘test1@kftest’ // 可选(指定某个客服发送, 会显示这个客服的头像) ]);

主动发送图文消息

$api->send($msg[‘FromUserName’], [ ‘type’ => 'news’, ‘articles’ => [ [ ‘title’ => '图文消息标题1’, // 可选 ‘description’ => '图文消息描述1’, // 可选 ‘picurl’ => 'http://me.diary8.com/data/img/demo1.jpg’, // 可选 ‘url’ => ‘http://www.example.com/’ // 可选 ], [ ‘title’ => '图文消息标题2’, ‘description’ => '图文消息描述2’, ‘picurl’ => 'http://me.diary8.com/data/img/demo2.jpg’, ‘url’ => ‘http://www.example.com/’ ], [ ‘title’ => '图文消息标题3’, ‘description’ => '图文消息描述3’, ‘picurl’ => 'http://me.diary8.com/data/img/demo3.jpg’, ‘url’ => ‘http://www.example.com/’ ], ], ‘kf_account’ => ‘test1@kftest’ // 可选(指定某个客服发送, 会显示这个客服的头像) ]);

Api：多客服功能（客服管理、多客服回话控制、获取客服聊天记录等）

官方:客服消息

添加客服账号

$api->add_kf('test1234@微信号’, '客服昵称’, ‘客服密码’);

设置客服信息

$api->update_kf('test1234@微信号’, '客服昵称’, ‘客服密码’);

上传客服头像

$api->set_kf_avatar('GB2@gbchina2000’, ‘/website/wx/demo/test.jpg’);

删除客服帐号

$api->del_kf(‘test1234@微信号’);

获取所有客服账号****获取在线客服接待信息

$api->get_online_kf_list();

获取客服聊天记录接口

$api->get_kf_records(1439348167, 1439384060, 1, 10);

创建客户与客服的会话

$api->create_kf_session('ocNtAt_K8nRlAdmNEo_R0WVg_rRw’, 'test1@微信号’, ‘小明请求接入会话!’);

关闭客户与客服的会话

$api->close_kf_session('ocNtAt_K8nRlAdmNEo_R0WVg_rRw’, 'test1@微信号’, ‘与小明的回话已关闭!’);

获取客户的会话状态

$api->get_kf_session(‘ocNtAt_K8nRlAdmNEo_R0WVg_rRw’);

获取客服的会话列表

$api->get_kf_session_list(‘test1@微信号’);

获取未接入会话列表的客户

$api->get_waitcase_list();

Api：素材管理（临时素材、永久素材、素材统计）

官方:素材管理

新增临时素材

$api->upload_media('image’, ‘/data/img/fighting.jpg’); $api->upload_media('voice’, ‘/data/img/song.amr’); $api->upload_media('video’, ‘/data/img/go.mp4’); $api->upload_media('thumb’, ‘/data/img/sky.jpg’);

获取临时素材URL

$api->get_media('UNsNhYrHG6e0oUtC8AyjCntIW1JYoBOmmwvM4oCcxZUBQ5PDFgeB9umDhrd9zOa-');

下载临时素材

header(‘Content-type: image/jpg’); list($err, $data) = $api->download_media('UNsNhYrHG6e0oUtC8AyjCntIW1JYoBOmmwvM4oCcxZUBQ5PDFgeB9umDhrd9zOa-'); echo $data;

新增永久素材

// 新增图片素材 list($err, $res) = $api->add_material('image’, ‘/website/me/data/img/fighting.jpg’); // 新增音频素材 list($err, $res) = $api->add_material('voice’, ‘/data/img/song.amr’); // 新增视频素材 list($err, $res) = $api->add_material('video’, '/website/me/data/video/2.mp4’, '视频素材的标题’, ‘视频素材的描述’); // 新增略缩图素材 list($err, $res) = $api->add_material('thumb’, ‘/data/img/sky.jpg’);

新增永久图文素材

$api->add_news([ [ ‘title’ => '标题’, ‘thumb_media_id’ => '图文消息的封面图片素材id（必须是永久mediaID）’, ‘author’ => '作者’, ‘digest’ => '图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空’, ‘show_cover_pic’ => '是否显示封面，0为false，即不显示，1为true，即显示’, ‘content’ => '图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS’, ‘content_source_url’ => ‘图文消息的原文地址，即点击“阅读原文”后的URL’ ], [ ‘title’ => '这是图文的标题’, ‘thumb_media_id’ => 'BZ-ih-dnjWDyNXjai6i6sdvxOoXOHr9wO0pgMhcZR8g’, ‘author’ => '这是图文的作者’, ‘digest’ => '’, ‘show_cover_pic’ => true, ‘content’ => '这是图文消息的具体内容’, ‘content_source_url’ => ‘http://www.baidu.com/’ ], ]);

修改永久图文素材

list($err, $res) = $api->update_news('BZ-ih-dnjWDyNXjai6i6sZp22xhHu6twVYKNPyl77Ms’, [ ‘title’ => '标题’, ‘thumb_media_id’ => 'BZ-ih-dnjWDyNXjai6i6sdvxOoXOHr9wO0pgMhcZR8g’, ‘author’ => '作者’, ‘digest’ => '图文消息的摘要’, ‘show_cover_pic’ => true, ‘content’ => '图文消息的具体内容’, ‘content_source_url’ => ‘http://www.diandian.com/’ ], 1);

获取永久素材

// 获取图片、音频、略缩图素材 // 返回素材的内容，可保存为文件或直接输出 header(‘Content-type: image/jpg’); list($err, $data) = $api->get_material(‘BZ-ih-dnjWDyNXjai6i6sdvxOoXOHr9wO0pgMhcZR8g’); echo $data;

// 获取视频素材 // 返回带down_url的json字符串 list($err, $data) = $api->get_material(‘BZ-ih-dnjWDyNXjai6i6sbOICualzdwwnWWBqxW39Xk’); var_dump(json_decode($data));

// 获取图文素材 // 返回图文的json字符串 list($err, $data) = $api->get_material(‘BZ-ih-dnjWDyNXjai6i6sdvxOoXOHr9wO0pgMhcZR8g’); var_dump(json_decode($data));

删除永久素材

list($err, $res) = $api->del_material(‘BZ-ih-dnjWDyNXjai6i6sbOICualzdwwnWWBqxW39Xk’); if (is_null($err)) { // 删除成功 }

获取素材总数

$api->get_material_count();

获取素材列表

$api->get_materials('image’, 0, 20); $api->get_materials('voice’, 0, 20); $api->get_materials('video’, 0, 20); $api->get_materials('thumb’, 0, 20);

Api：自定义菜单管理（创建、查询、删除菜单）

官方:自定义菜单

自定义菜单创建接口

$api->create_menu(' { "button":[ { "type":"click", "name":"主菜单1", “key":"V1001_TODAY_MUSIC” }, { "name":"主菜单2", "sub_button":[ { "type":"click", "name":"点击推事件", “key":"click_event1” }, { "type":"view", "name":"跳转URL", “url":"http://www.example.com/” }, { "type":"scancode_push", "name":"扫码推事件", “key":"scancode_push_event1” }, { "type":"scancode_waitmsg", "name":"扫码带提示", “key":"scancode_waitmsg_event1” } ] }, { "name":"主菜单3", "sub_button":[ { "type":"pic_sysphoto", "name":"系统拍照发图", “key":"pic_sysphoto_event1” }, { "type":"pic_photo_or_album", "name":"拍照或者相册发图", “key":"pic_photo_or_album_event1” }, { "type":"pic_weixin", "name":"微信相册发图", “key":"pic_weixin_event1” }, { "type":"location_select", "name":"发送位置", “key":"location_select_event1” } ] } ] }’);

自定义菜单查询接口****自定义菜单删除接口****获取自定义菜单配置接口****Api：微信JSSDK（生成微信JSSDK所需的配置信息）

官方:JS-SDK说明文档

获取JS-SDK配置需要的信息

使用前请确认，初始化Api时，已填写并实现了get_jsapi_ticket和save_jsapi_ticket

$api->get_jsapi_config(); $api->get_jsapi_config(‘http://www.baidu.com/’);

$api->get_jsapi_config('’, ‘json’); $api->get_jsapi_config('’, ‘jsonp’); $api->get_jsapi_config('’, 'jsonp’, ‘callback’);

Api：账号管理（生成带参数的二维码、长链接转短链接接口）

官方:账户管理

生成带参数的二维码

list($err, $data) = $api->create_qrcode(1234); // 创建一个永久二维码 list($err, $data) = $api->create_qrcode(1234, 100); //创建一个临时二维码，有效期100秒

通过ticket换取二维码，返回二维码url地址

$api->get_qrcode_url(‘gQH58DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xLzQweUctT2psME1lcEJPYWJkbUswAAIEApzVVQMEZAAAAA==’);

通过ticket换取二维码，返回二维码图片的内容

list($err, $data) = $api->get_qrcode(‘gQGa8ToAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xLzlVeXJZWS1seGNlODZ2SV9XMkMwAAIEo5rVVQMEAAAAAA==’); header(‘Content-type: image/jpg’); echo $data;

长链接转短链接接口

list($err, $data) = $api->shorturl(‘http://me.diary8.com/category/web-front-end.html’); echo $data->short_url;

Api：用户管理

包含：用户分组管理、设置用户备注名、获取用户基本信息、获取用户列表、网页授权获取用户基本信息

官方:用户管理

用户分组管理 - 创建分组

list($err, $data) = $api->create_group(‘新的一个分组’); echo $data->group->id;

用户分组管理 - 查询所有分组

list($err, $data) = $api->get_groups(); foreach ($data->groups as $group) { var_dump($group); }

用户分组管理 - 查询用户所在分组

list($err, $data) = $api->get_user_group(‘ocNtAt0YPGDme5tJBXyTphvrQIrc’); echo $data->groupid;

用户分组管理 - 修改分组名

$api->update_group(100, ‘自定义分组了’);

用户分组管理 - 移动用户分组

$api->update_user_group('ocNtAt0YPGDme5tJBXyTphvrQIrc’, 100);

用户分组管理 - 批量移动用户分组

$api->batchupdate_user_group([ 'ocNtAt0YPGDme5tJBXyTphvrQIrc’, 'ocNtAt_TirhYM6waGeNUbCfhtZoA’, ‘ocNtAt_K8nRlAdmNEo_R0WVg_rRw’ ], 100);

用户分组管理 - 删除分组****设置用户备注名

$api->update_user_remark('ocNtAt0YPGDme5tJBXyTphvrQIrc’, ‘用户的备注名’);

获取用户基本信息

$api->get_user_info(‘ocNtAt_K8nRlAdmNEo_R0WVg_rRw’); $api->get_user_info('ocNtAt_K8nRlAdmNEo_R0WVg_rRw’, ‘zh_TW’);

获取用户列表

$api->get_user_list(); $api->get_user_list(‘ocNtAt_TirhYM6waGeNUbCfhtZoA’);

网页授权获取用户基本信息

有两种授权类型：

1. snsapi_base 静默授权，用户无感知，但只能获取到openid
2. snsapi_userinfo 可以获得openid、昵称、性别、所在地等更详细的信息，但首次授权会跳转微信的一个授权页面，用户点击同意后授权成功

两种授权流程使用说明：

demo见项目内 demo/snsapi/

1. 通过 get_authorize_url 生成获取用户授权的链接，用户打开该链接后会跳转到 回调地址页面

   $api->get_authorize_url('授权类型’, ‘回调地址’); $api->get_authorize_url(‘snsapi_base’,’http://wx.diary8.com/demo/snsapi/callback_snsapi_base.php’); $api->get_authorize_url('snsapi_userinfo’, ‘http://wx.diary8.com/demo/snsapi/callback_snsapi_userinfo.php’);

2. 在 回调地址页面 通过 get_userinfo_by_authorize 获取用户信息

   list($err, $user_info) = $api->get_userinfo_by_authorize(‘snsapi_base’); if ($user_info !== null) { var_dump($user_info);; } else { echo '授权失败！’; }

   list($err, $user_info) = $api->get_userinfo_by_authorize(‘snsapi_userinfo’); if ($user_info !== null) { var_dump($user_info);; } else { echo '授权失败！’; }

Api：微信公众号支付(JSAPI)

官方:JSAPI支付

官方:SDK与DEMO下载

支付过程中SDK使用流程：

• 通过 网页授权获取用户基本信息 openid
• 调用 wxPayUnifiedOrder 生成预订单
• 调用 getWxPayJsApiParameters 生成jsapi支付的参数，作为js调用支付接口的参数

eg: api

/* @var $cache \yii\redis\cache */ $cache = \Yii::$app->cache;

$api = new Api([ ‘appId’ => 'wx312273d5za28s525’, //AppID ‘appSecret’ => '7d8e268465d6ec7ch2f4ed2364h5ef32’, //AppSecret ‘mchId’ => '1633246021’, //微信支付商户号 ‘key’ => '613A60282Aa87E2B1A22E3A3DFD9AE32A’, //微信商户API密钥 ‘get_access_token’ => function() use ($cache) { return $cache->get(‘WE_CHAT_SDK_ACCESS_TOKEN’); }, ‘save_access_token’ => function($token) use ($cache) { $cache->set('WE_CHAT_SDK_ACCESS_TOKEN’, $token); } ]);;

eg: 页面内调起微信支付

// 获取用户的openid list($err, $user_info) = $api->get_userinfo_by_authorize(‘snsapi_base’); if ($user_info == null) { $url = $api->get_authorize_url('snsapi_base’, Yii::$app->request->absoluteUrl); return $this->controller->redirect($url); }

// 生成预订单 $wxOrder = $api->wxPayUnifiedOrder([ ‘trade_type’ => 'JSAPI’, ‘out_trade_no’ => '100002’, ‘body’ => ‘新鲜大白菜’, ‘total_fee’ => 100, // 单位是分 //’time_expire’ => date('YmdHis’, (int)$order[‘created_at’] + (int)$order[‘timeout’]), ‘notify_url’ => 'http://example.com/we-chat-pay/asyn-notify’, ‘openid’ => $user_info->openid, ]);

// 判断预订单是否生成成功 if ($wxOrder[‘return_code’] == ‘SUCCESS’ && $wxOrder[‘result_code’] == ‘SUCCESS’) { // 成功处理，获取JSAPI支付的参数 $jsApiParams = $api->getWxPayJsApiParameters($wxOrder[‘prepay_id’]); } else { // 失败处理… }

<html> <head> <meta http-equiv="content-type" content="text/html;charset=utf-8"/> <meta name="viewport" content="width=device-width, initial-scale=1"/> <title>微信支付</title> <script type="text/javascript"> function jsApiCall() { WeixinJSBridge.invoke( 'getBrandWCPayRequest’, <?= $jsApiParams ?>, function(res){ alert(JSON.stringfy(res)); WeixinJSBridge.log(res.err_msg); alert(res.err_code+res.err_desc+res.err_msg); } ); } if (typeof WeixinJSBridge == ‘undefined’){ if( document.addEventListener ){ document.addEventListener('WeixinJSBridgeReady’, jsApiCall, false); }else if (document.attachEvent){ document.attachEvent('WeixinJSBridgeReady’, jsApiCall); document.attachEvent('onWeixinJSBridgeReady’, jsApiCall); } }else{ jsApiCall(); } </script> </head> </html>

eg: 处理微信支付结果异步回调

// 处理微信支付异步通知 // $res: 是否支付成功 // $notifyData: 异步通知的原始数据 // $replyData: 回复微信异步通知的数据 list($res, $notifyData, $replyData) = $api->progressWxPayNotify();

// 处理业务逻辑 // …

// 回复微信 $api->replyWxPayNotify($replyData); exit();

常见问题

• redirect_uri参数错误 开发者中心->功能服务[网页账号:网页授权获取用户基本信息]->修改->填写回调的域名
• 当前页面的URl未注册 微信支付->公众号支付填写支付授权目录
• 微信支付结果通过纯post xml通知，但PHP7移除了 HTTP_RAW_POST_DATA，这里使用 php://input

Api：微信App支付(App)

官方:APP支付

微信App支付与微信公众号支付类似：

支付过程中SDK使用流程：

• [商户服务器]调用 wxPayUnifiedOrder 生成预订单
• [商户服务器]调用 getWxPayAppApiParameters 生成App支付的参数，作为自己App调起微信打开支付界面的参数
• [商户App客户端]通过以上的支付参数调用移动端SDK调起微信支付 见官方wiki
• 支付成功后，微信会异步通知[商户服务器]的notify_url，[商户服务器]调用 progressWxPayNotify 验证异步通知并做相应业务操作

eg: 写个服务端接口[生成预订单,并得到App的支付参数] 供客户端App调用

// 生成预订单 $wxOrder = $api->wxPayUnifiedOrder([ ‘trade_type’ => 'APP’, ‘out_trade_no’ => '100002’, ‘body’ => ‘新鲜大白菜’, ‘total_fee’ => 100, // 单位是分 //’time_expire’ => date('YmdHis’, (int)$order[‘created_at’] + (int)$order[‘timeout’]), ‘notify_url’ => 'http://example.com/we-chat-pay/asyn-notify’, ]);

// 判断预订单是否生成成功 if ($wxOrder[‘return_code’] == ‘SUCCESS’ && $wxOrder[‘result_code’] == ‘SUCCESS’) { // 成功处理，获取App支付的参数 $apiParams = $api->getWxPayAppApiParameters($wxOrder[‘prepay_id’]);

// 返回给app客户端
return json\_encode($apiParams);

} else { // 失败处理… }

# iOS调起微信支付 (微信官网的，未验证)

PayReq *request = [[[PayReq alloc] init] autorelease];
request.partnerId = @"10000100";
request.prepayId= @"1101000000140415649af9fc314aa427";
request.package = @"Sign=WXPay";
request.nonceStr= @"a462b76e7436e98e0ed6e13c64b4fd1c";
request.timeStamp= @"1397527777";
request.sign= @"582282D72DD2B03AD892830965F428CB16E7A256";
[WXApi sendReq：request];


# android调起微信支付 (微信官网的，未验证)

IWXAPI api;
PayReq request = new PayReq();
request.appId = "wxd930ea5d5a258f4f";
request.partnerId = "1900000109";
request.prepayId= "1101000000140415649af9fc314aa427",;
request.packageValue = "Sign=WXPay";
request.nonceStr= "1101000000140429eb40476f8896f4c9";
request.timeStamp= "1398746574";
request.sign= "7FFECB600D7157C5AA49810D2D8F28BC2811827B";
api.sendReq(req);

eg: 处理微信支付结果异步回调

// 处理微信支付异步通知 // $res: 是否支付成功 // $notifyData: 异步通知的原始数据 // $replyData: 回复微信异步通知的数据 list($res, $notifyData, $replyData) = $api->progressWxPayNotify();

// 处理业务逻辑 // …

// 回复微信 $api->replyWxPayNotify($replyData); exit();

微信硬件平台基础消息接口

官方:微信硬件平台基础消息接口

获取设备二维码

$api->device_create_qrcode(‘设备ID’);

设备授权

$api->device_authorize_device($device, $opType, $productId);

通过openid获取用户绑定的deviceid

$api->device_get_bind_device($openId);

获取设备绑定openID

$api->device_get_openid($deviceId);

设备状态查询

$api->device_get_stat($deviceId);

强制绑定用户和设备

$api->device_compel_bind($deviceId, $openId);

强制解绑用户和设备

$api->device_compel_unbind($deviceId, $openId);

主动发送消息给设备

$api->device_transmsg($deviceId, $openId, $content);

第三方主动发送设备状态消息给微信终端

$api->device_transmsg_device_status($deviceId, $openId, $deviceStatus);

License

MIT