wechat-php-sdk

wechat-php-sdk ============== 微信公众平台php开发包,细化各项接口操作,支持链式调用,欢迎Fork此项目 weixin developer SDK. 项目地址：**https://github.com/dodgepudding/wechat-php-sdk** 项目blog：**http://binsee.github.io/wechat-php-sdk** ## 使用详解 使用前需先打开微信帐号的开发模式，详细步骤请查看微信公众平台接口使用说明： 微信公众平台： http://mp.weixin.qq.com/wiki/ 微信企业平台： http://qydev.weixin.qq.com/wiki/ 微信支付接入文档： https://mp.weixin.qq.com/cgi-bin/readtemplate?t=business/course2_tmpl&lang=zh_CN 微信多客服：http://dkf.qq.com ## 目录 > **[wechat.class.php 官方API类库](#user-content-1-wechatclassphp-官方api类库)** > **[qywechat.class.php 企业号API类库](#user-content-6-qywechatclassphp-企业号api类库)** > **[errCode.php|qyerrCode.php 全局返回码类](#user-content-5-errcodephp-全局返回码类)** > **[old_version/wechatpay.class.php 旧版微信支付V2接口类库](#user-content-7-wechatpayclassphp-旧版微信支付V2接口类库)** > ~~**[old_version/wechatext.class.php 非官方扩展API(停止维护)](#user-content-2-wechatextclassphp-非官方扩展api)**~~ > ~~**[old_version/wechatauth.class.php 授权登陆(停止维护)](#user-content-3-wechatauthclassphp-授权登陆)**~~ > ~~**[old_version/wechat.js 内嵌JS(已废弃)](#user-content-4-wechatjs-内嵌js)**~~ > **[为开发框架进行适配](#user-content-为开发框架进行适配)** > **[调用示例](#user-content-调用示例)** ---------- ## 1. wechat.class.php 官方API类库 调用官方API，具有更灵活的消息分类响应方式，支持链式调用操作 ； ### 主要功能 - 接入验证 **（初级权限）** - 自动回复（文本、图片、语音、视频、音乐、图文） **（初级权限）** - 菜单操作（查询、创建、删除） **（菜单权限）** - 客服消息（文本、图片、语音、视频、音乐、图文） **（认证权限）** - 二维码（创建临时、永久二维码，获取二维码URL） **（服务号、认证权限）** - 长链接转短链接接口 **（服务号、认证权限）** - 分组操作（查询、创建、修改、移动用户到分组） **（认证权限）** - 网页授权（基本授权，用户信息授权） **（服务号、认证权限）** - 用户信息（查询用户基本信息、获取关注者列表） **（认证权限）** - 多客服功能（客服管理、获取客服记录、客服会话管理） **（认证权限）** - 媒体文件（上传、获取） **（认证权限）** - 高级群发 **（认证权限）** - 模板消息（设置所属行业、添加模板、发送模板消息） **（服务号、认证权限）** - 卡券管理（创建、修改、删除、发放、门店管理等） **（认证权限）** - 语义理解 **（服务号、认证权限）** - 获取微信服务器IP列表 **（初级权限）** - 微信JSAPI授权(获取ticket、获取签名) **（初级权限）** - 数据统计(用户、图文、消息、接口分析数据) **（认证权限）** > 备注： > 初级权限：基本权限，任何正常的公众号都有此权限 > 菜单权限：正常的服务号、认证后的订阅号拥有此权限 > 认证权限：分为订阅号、服务号认证，如前缀服务号则仅认证的服务号有此权限，否则为认证后的订阅号、服务号都有此权限 > 支付权限：仅认证后的服务号可以申请此权限 ### 初始化动作 ```php $options = array( 'token'=>'tokenaccesskey', //填写你设定的key 'encodingaeskey'=>'encodingaeskey', //填写加密用的EncodingAESKey 'appid'=>'wxdk1234567890', //填写高级调用功能的app id, 请在微信开发模式后台查询 'appsecret'=>'xxxxxxxxxxxxxxxxxxx' //填写高级调用功能的密钥 ); $weObj = new Wechat($options); //创建实例对象 //TODO：调用$weObj各实例方法 ``` ### 被动接口方法: * valid() 验证连接，被动接口处于加密模式时必须调用 * * getRev() 获取微信服务器发来信息(不返回结果)，被动接口必须调用 * getRevData() 返回微信服务器发来的信息（数组） * getRevFrom() 返回消息发送者的userid * getRevTo() 返回消息接收者的id（即公众号id） * getRevType() 返回接收消息的类型 * getRevID() 返回消息id * getRevCtime() 返回消息发送时间 * getRevContent() 返回消息内容正文或语音识别结果（文本型） * getRevPic() 返回图片信息（图片型信息） 返回数组{'mediaid'=>'','picurl'=>''} * getRevLink() 接收消息链接（链接型信息） 返回数组{'url'=>'','title'=>'','description'=>''} * getRevGeo() 返回地理位置（位置型信息） 返回数组{'x'=>'','y'=>'','scale'=>'','label'=>''} * getRevEventGeo() 返回事件地理位置（事件型信息） 返回数组{'x'=>'','y'=>'','precision'=>''} * getRevEvent() 返回事件类型（事件型信息） 返回数组{'event'=>'','key'=>''} * getRevScanInfo() 获取自定义菜单的扫码推事件信息，事件类型为`scancode_push`或`scancode_waitmsg` 返回数组array ('ScanType'=>'qrcode','ScanResult'=>'123123') * getRevSendPicsInfo() 获取自定义菜单的图片发送事件信息,事件类型为`pic_sysphoto`或`pic_photo_or_album`或`pic_weixin` 数组结构见php文件内方法说明 * getRevSendGeoInfo() 获取自定义菜单的地理位置选择器事件推送，事件类型为`location_select` 数组结构见php文件内方法说明 * getRevVoice() 返回语音信息（语音型信息） 返回数组{'mediaid'=>'','format'=>''} * getRevVideo() 返回视频信息（视频型信息） 返回数组{'mediaid'=>'','thumbmediaid'=>''} * getRevTicket() 返回接收TICKET（扫描带参数二维码,关注或SCAN事件） 返回二维码的ticket值 * getRevSceneId() 返回二维码的场景值（扫描带参数二维码的关注事件） 返回二维码的参数值 * getRevTplMsgID() 返回主动推送的消息ID（群发或模板消息事件） 返回MsgID值 * getRevStatus() 返回模板消息发送状态（模板消息事件） 返回文本：success(成功)|failed:user block(用户拒绝接收)|failed: system failed(发送失败（非用户拒绝）) * getRevResult() 返回群发或模板消息发送结果（群发或模板消息事件） 返回数组，内容依事件类型而不同，参考开发文档中群发、模板消息推送事件 * getRevKFCreate() 返回多客服-接入会话的客服账号（多客服-接入会话事件） 返回文本型 * getRevKFClose() 返回多客服-处理会话的客服账号（多客服-接入会话事件） 返回文本型 * getRevKFSwitch() 返回多客服-转接会话信息（多客服-转接会话事件） 返回数组 {'FromKfAccount' => '','ToKfAccount' => ''} * getRevCardPass() 返回卡券-审核通过的卡券ID（卡券-卡券审核事件） 返回文本型 * getRevCardGet() 返回卡券-用户领取卡券的相关信息（卡券-领取卡券事件） 返回数组{'CardId' => '','IsGiveByFriend' => '','UserCardCode' => ''} * getRevCardDel() 返回卡券-用户删除卡券的相关信息（卡券-删除卡券事件） 返回数组{'CardId' => '','UserCardCode' => ''} * * text($text) 设置文本型消息，参数：文本内容 * image($mediaid) 设置图片型消息，参数：图片的media_id * voice($mediaid) 设置语音型消息，参数：语音的media_id * video($mediaid='',$title,$description) 设置视频型消息，参数：视频的media_id、标题、摘要 * music($title,$desc,$musicurl,$hgmusicurl='',$thumbmediaid='') 设置回复音乐，参数：音乐标题、音乐描述、音乐链接、高音质链接、缩略图的媒体id * news($newsData) 设置图文型消息，参数：数组。数组结构见php文件内方法说明 * Message($msg = '',$append = false) 设置发送的消息（一般不需要调用这个方法） * transfe