wechat-php-sdk

最新推荐文章于 2021-03-10 09:49:07 发布
最新推荐文章于 2021-03-10 09:49:07 发布
阅读量545 收藏
点赞数
原文链接：http://www.cnblogs.com/CHEUNGKAMING/p/5813296.html
版权

 

wechat-php-sdk

微信公众平台php版开发包

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

功能模块

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

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

 

DEMO

项目内 demo/demo_simple.php

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

use Gaoming13\WechatPhpSdk\Wechat;

$wechat = new Wechat(array(     
    '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; ...
  1. 使用 composer
  #安装composer依赖
  composer require "gaoming13/wechat-php-sdk:1.5.*"
  composer dump-autoload --optimize

  require "vendor/autoload.php";
  use Gaoming13\WechatPhpSdk\Wechat;
  use Gaoming13\WechatPhpSdk\Api;
  1. ThinkPHP 内使用

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

Thinkphp控制器内使用SDK的DEMO:

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

  $wechat = new \Gaoming13\WechatPhpSdk\Wechat(array(       
    'appId' => $appId,  
    'token' =>  $token,
    'encodingAESKey' => $encodingAESKey
  ));

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

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

官方wiki

以项目中的 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(array( 
    // 开发者中心-配置项-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: 接收普通消息/事件推送

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

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

$msg = $wechat->serve();

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

官方wiki

回复文本消息

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

回复图片消息

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

回复语音消息

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

回复视频消息

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

回复音乐消息

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

Wechat: 转发到多客服接口

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

Api: 模块使用说明

access_token需要用户自己实现缓存

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

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

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

$api = new Api(
    array(
        '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(array(     
    'appId' => $appId,  
    'token' =>  $token,
    'encodingAESKey' => $encodingAESKey
));

// api模块 - 包含各种系统主动发起的功能
$api = new Api(
    array(
        '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模块的接口返回值格式为: array($err, $data);

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

可用list接收:

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

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

官方wiki

主动发送文本消息

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

主动发送图片消息

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

主动发送语音消息

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

主动发送视频消息

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

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

官方wiki

添加客服账号

$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_kf_list();

获取在线客服接待信息

$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：素材管理（临时素材、永久素材、素材统计）

官方wiki

新增临时素材

$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(array(
    array(
        'title' => '标题',
        'thumb_media_id' => '图文消息的封面图片素材id（必须是永久mediaID）',
        'author' => '作者',
        'digest' => '图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空',
        'show_cover_pic' => '是否显示封面，0为false，即不显示，1为true，即显示',
        'content' => '图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS',
        'content_source_url' => '图文消息的原文地址，即点击“阅读原文”后的URL'
    ),
    array(
        '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', array(
    '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：自定义菜单管理（创建、查询、删除菜单）

官方wiki

自定义菜单创建接口

$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->get_menu();

自定义菜单删除接口

$api->delete_menu();

获取自定义菜单配置接口

$api->get_selfmenu();

Api：微信JSSDK（生成微信JSSDK所需的配置信息）

官方wiki

获取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：账号管理（生成带参数的二维码、长链接转短链接接口）

官方wiki

生成带参数的二维码

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：用户管理（用户分组管理、设置用户备注名、获取用户基本信息、获取用户列表、网页授权获取用户基本信息）

官方wiki

用户分组管理 - 创建分组

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(array(
    'ocNtAt0YPGDme5tJBXyTphvrQIrc',
    'ocNtAt_TirhYM6waGeNUbCfhtZoA',
    'ocNtAt_K8nRlAdmNEo_R0WVg_rRw'
    ), 100);

用户分组管理 - 删除分组

$api->delete_group(102);

设置用户备注名

$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支付

官方wiki

官方SDK

支付过程中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($user_info->openid, [
    'out_trade_no' => JiariOrder::getOutTradeNo($order['id']),
    'body' => '[NO.'.$order['batch_id'].']'.$order['name'],
    'total_fee' => (double)$order['total_pay_need'] * 100,
    //'time_expire' => date('YmdHis', (int)$order['created_at'] + (int)$order['timeout']),
    'notify_url' => HTTP.'://my.'.IDN.'/we-chat-pay/asyn-notify',
]);
// 判断预订单是否生成成功
if ($wxOrder['return_code'] != 'SUCCESS') {
    Yii::error(['微信支付预订单生成失败', $wxOrder, $order], __METHOD__);

    throw new NotFoundHttpException('使用微信支付失败，请改用其它支付方式！');
}

// 生成微信支付JSAPI参数
if (! array_key_exists('prepay_id', $wxOrder)) {
    Yii::error(['微信支付预订单生成失败', $wxOrder, $order], __METHOD__);
    throw new NotFoundHttpException('使用微信支付失败，请改用其它支付方式！');
}
$jsApiParams = $api->getWxPayJsApiParameters($wxOrder['prepay_id']);

<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

License

MIT

转载于:https://www.cnblogs.com/CHEUNGKAMING/p/5813296.html

diaomao1439
关注
微信公众平台PHP开发包wechat-php-sdk.zip
07-19
微信公众平台 PHP 开发包，细化了微信的各项接口操作。调用官方API，具有更灵活的消息分类响应方式，支持链式调用操作 。 主要功能 接入验证 （初级权限） 自动回复（文本、图片、语音、视频、音乐、图文） （初级权限） 菜单操作（查询、创建、删除） （菜单权限） 客服消息（文本、图片、语音、视频、音乐、图文） （认证权限） 二维码（创建临时、永久二维码，获取二维码URL） （服务号、认证权限） 长链接转短链接接口 （服务号、认证权限） 分组操作（查询、创建、修改、移动用户到分组） （认证权限） 网页授权（基本授权，用户信息授权） （服务号、认证权限） 用户信息（查询用户基本信息、获取关注者列表） （认证权限） 多客服功能（客服管理、获取客服记录、客服会话管理） （认证权限） 媒体文件（上传、获取） （认证权限） 高级群发 （认证权限） 模板消息（设置所属行业、添加模板、发送模板消息） （服务号、认证权限） 卡券管理（创建、修改、删除、发放、门店管理等） （认证权限） 语义理解 （服务号、认证权限） 获取微信服务器IP列表 （初级权限） 微信JSAPI授权(获取ticket、获取签名) （初级权限） 数据统计(用户、图文、消息、接口分析数据) （认证权限） > 备注： > 初级权限：基本权限，任何正常的公众号都有此权限 > 菜单权限：正常的服务号、认证后的订阅号拥有此权限 > 认证权限：分为订阅号、服务号认证，如前缀服务号则仅认证的服务号有此权限，否则为认证后的订阅号、服务号都有此权限 > 支付权限：仅认证后的服务号可以申请此权限 初始化动作  $options = array(     'token'=>'tokenaccesskey', //填写你设定的key     'encodingaeskey'=>'encodingaeskey', //填写加密用的EncodingAESKey     'appid'=>'wxdk1234567890', //填写高级调用功能的app id, 请在微信开发模式后台查询     'appsecret'=>'xxxxxxxxxxxxxxxxxxx' //填写高级调用功能的密钥     );  $weObj = new Wechat($options); //创建实例对象  //TODO：调用$weObj各实例方法   标签：wechat
wechat-php-sdk：微信公众平台php版开发包
02-21
微信-PHP-SDK 微信公众平台php版开发包 支持消息加解密方式的明文模式，兼容模式，安全模式 支持自动接入微信公众平台（ ） 支持php5.3 + 相关参考 功能模块 微信（处理自动接收，获取与回复微信消息）（） Api...
[转]微信公众平台WeChat PHP SDK
weixin_34346099的博客
05-21 120
地址：https://github.com/dodgepudding/wechat-php-sdk 微信公众平台php开发包,细化各项接口操作,支持链式调用   微信支付接入文档： https://mp.weixin.qq.com/cgi-bin/readtemplate?t=business/course2_tmpl&amp;lang=zh_CN wechat.class.php ...
Wechat-sdk-php 详细介绍
weixin_30312557的博客
10-13 329
关于PHP微信SDK 此SDK运行最底要求PHP版本5.3.3, 建议在PHP7运行以获取最佳性能。 微信的部分接口需要缓存数据在本地，因此对目录需要有写权限。 我们鼓励大家使用composer来管理您的第三方库，方便后期更新操作（尤其是接口类）。 近期access_token经常无故失效，SDK已经加入失败状态检...
微信公众平台php开发包
slqgenius的博客
07-05 9051
微信公众平台php开发包,细化各项接口操作,支持链式调用,欢迎Fork此项目 weixin developer SDK. 项目地址：https://github.com/dodgepudding/wechat-php-sdk 项目blog：http://binsee.github.io/wechat-php-sdk 使用详解 使用前需先打开微信帐号的开发模式，详细步骤请查看微信公众
wechat-php-sdk-master.zip_wechat_wechat辅助验证_微信_微信 php_微信SDK
09-21
微信验证类微信验证类微信验证类微信验证类微信验证类
wechat-php-sdk:微信公众平台php开发包，对 https
05-29
wechat-php-sdk 微信公众平台php开发包，对 做的composer适用版本 原始项目 原来这个项目只做了composer，但是没有按照标准类库的格式制作，所以单独复制了一份，按照composer的autoload的要求改了下。
wechat-cakephp-sdk:微信-cakephp-sdk
06-29
在wechat-php-sdk上修改适配cakephp, controller中有使用范例 项目地址： ###更新 Wechat.php中增加适配CakePHP的缓存配置,也可以根据实际情况在WechatCache中改为其他的缓存类 增加CakePHP使用范例 2014-12-25 增加...
Wechat.class.php 微信公众平台PHP-SDK
08-22
Wechat.class.php 微信公众平台PHP-SDK 封装了微信公众号开发的基本功能 只给公众号互动的用户提供服务
Wechat_PHP_SDK:wechat-php-sdk 微信开源SDK
05-24
Zebra-Wechat 微信SDK 目前处于开发状态，目前实现了以下功能： 接收微信服务器推送信息，对推送信息类型进行识别 微信API客户端封装（用户管理、用户组管理、客服管理、自定义菜单管理、系统管理等） 微信跳转验证封装 微信卡卷支持 接收微信推送示例 use \Jenner\Zebra\Wechat\WechatServer; use \Jenner\Zebra\Wechat\Response\TextResponse; $token = 'you wechat token'; $server = new WechatServer($token); //处理事件前调用，无论是否有注册事件处理器 $server->on('before', function(WechatServer $server, $request){ //do something }); //处理事件后调
最新最全的微信公众平台PHP-SDK
05-05
微信公众平台PHP-SDK, 官方API部分
微信api.php（已实现token验证，输入自动回复，关注自动回复）
04-23
现在在自己琢磨微信开发，做了一点小东西，实现了token验证，之前就看见好多新手都会不知道URL是什么，token验证失败，不知道怎么实现关注自动回复，大家可以看看我的api.php，希望对大家有所收获，有问题可以留言交流~
微信公众号 php sdk,GitHub - yuanchenglu/wechat-php-sdk: 微信公众平台 PHP SDK
weixin_42503813的博客
03-09 298
微信公众平台 PHP SDK介绍简单的微信公众平台 PHP SDK ，通过调用相应的接口，使你可以轻松地开发微信 App 。测试方法如下：Clone 或下载项目源码，上传至服务器。进入微信公众平台，高级功能，开启开发模式，并设置接口配置信息。修改 URL 为 /example/server.php 的实际位置，修改 Token 为 weixin (可自行在 /example/server.php ...
PHP微信SDK——Zebra-Wechat
始终不够
12-16 6977
PHP微信SDK——Zebra-Wechat
微信公众号--php
kevin_cat的博客
08-15 5073
1搭建环境 2安装php   3在ThinkPHP/Linbrary/Org/Wx文件夹下创建一个Wx文件夹，存放Wechat.class.php             WeChat.class.php &lt;?php /**  *    微信公众平台PHP-SDK, 官方API部分  *  @author  dodge &lt;dodge...
php 微信开发sdk,微信开放平台SDK，简易教程
weixin_34274954的博客
03-10 750
/*** 授权后代替公众号实现业务* @author lv_fan2008@sina.com*/include_once "config.php";include_once dirname(dirname(__FILE__)) . "/src/WxComponentService.class.php";$cfg = get_wx_config();if (!$cfg) {die("no acce...
微信JS-SDK自定义分享功能全面解析与实战示例
微信JS-SDK自定义分享功能实例详解深入剖析了如何利用微信JavaScript接口（JS-SDK）在网页应用中实现分享给好友和发布到微信朋友圈的功能。本文首先讲解了配置JS-SDK的基础步骤，包括设置appid、appsecret，并生成...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值