README

#微信公众平台 Laravel SDK

##使用帮助

###说明

用 Laravel Facade 封装了 dodgepudding/wechat-php-sdk，目前只添加了 wechat.class 官方API类库，欢迎提交issue。

###1、安装

请先确认已经安装Composer. 编辑 composer.json 文件，然后加入 vin/wechat.

"require": {
    "vin/wechat": "dev-master"
}

更新包 composer update 。

需要添加以下服务到系统。

打开 app/config/app.php ，在'providers' 下添加：

'Vin\LaravelWechat\ServiceProvider\WechatServiceProvider',

在'aliases' 下添加：

'Wechat' => 'Vin\LaravelWechat\Facade\Wechat',

然后配置文件 app/config/wechat.php 。

return [
    'default'=>
        [
            'appid'         => '', 
            'appsecret'     => '', 
            'encodingAesKey'=> '',
            'mchid'         => '', 
            'mchkey'        => ''
        ]
];

##2、使用

// 获取用户列表
//关注回复
Wechat::event('subscribe',function($wechat){
	echo $wechat->text('欢迎关注我们!')->reply('', true);
});
Wechat::event('unsubscribe',function($wechat){
    echo $reply = $wechat->text('欢迎再次关注我们!')->reply('',true);
    $oldUser = WechatUsers::whereOpenid($wechat->getRevFrom())->first();
    $oldUser->subscribe = 0;
    $oldUser->save();
    $this->_log($wechat, $reply);
});
//扫描带参数二维码事件（用户已关注时）
Wechat::event('SCAN',function($wechat){
    $event = $wechat->getRevEvent();
    //扫描带参数二维码事件
    $qr = MarketToolsChannelQrcode::find($event['key']);
    if($qr && $qr->reply_style){
	$arr = explode('|',$qr->reply_style);
	echo $reply = (new WechatReply)->xmlReplyForWechatById($wechat, $arr[1], $arr[0]);
    }else{
	echo $reply = $wechat->text('欢迎关注我们!')->reply('',true);
    }
    $this->_log($wechat, $reply);
});
//点击菜单拉取消息时的事件推送
Wechat::event('CLICK',function($wechat){
    $reply = (new WechatReply)->xmlReplyForWechatByKeyword($wechat);
    if(empty($reply))
	echo $reply = $wechat->text('欢迎关注我们!')->reply('',true);
    else
	echo $reply;
    $this->_log($wechat, $reply);
});
//默认事件
Wechat::on('event',function($wechat){
    echo $reply = $wechat->text('event:'.var_export($wechat->getRevData(),true))->reply('',true);
    $this->_log($wechat, $reply);
});

Wechat::on('message', 'location', function($wechat){
    $geo = $this->getRevGeo();
    if(empty($geo))
	echo $reply = $wechat->text('欢迎关注我们!')->reply('',true);
    else
	echo $reply = $wechat->text($geo['label'])->reply('',true);
    $this->_log($wechat, $reply);
});
Wechat::on('message', 'text', function($wechat){
    $reply = (new WechatReply)->xmlReplyForWechatByKeyword($wechat);
    if(empty($reply))
	echo $reply = $wechat->text('欢迎关注我们!')->reply('',true);
    else
	echo $reply;
    $this->_log($wechat, $reply);
});
Wechat::on('message', function($wechat){
    $reply = (new WechatReply)->xmlReplyForWechatByKeyword($wechat);
    if(empty($reply))
	echo $reply = $wechat->text('欢迎关注我们!')->reply('',true);
    else
	echo $reply;
    $this->_log($wechat, $reply);
});
//运行
Wechat::run();

##3、主要功能

接入验证 （初级权限）
自动回复（文本、图片、语音、视频、音乐、图文） （初级权限）
菜单操作（查询、创建、删除） （菜单权限）
客服消息（文本、图片、语音、视频、音乐、图文） （认证权限）
二维码（创建临时、永久二维码，获取二维码URL） （服务号、认证权限）
长链接转短链接接口 （服务号、认证权限）
分组操作（查询、创建、修改、移动用户到分组） （认证权限）
网页授权（基本授权，用户信息授权） （服务号、认证权限）
用户信息（查询用户基本信息、获取关注者列表） （认证权限）
多客服功能（客服管理、获取客服记录、客服会话管理） （认证权限）
媒体文件（上传、获取） （认证权限）
调用地址组件 （支付权限）
生成订单签名数据 （支付权限）
订单成功回调 （支付权限）
发货通知 （支付权限）
支付订单查询 （支付权限）
高级群发 （认证权限）
模板消息（设置所属行业、添加模板、发送模板消息） （服务号、认证权限）
卡券管理（创建、修改、删除、发放、门店管理等） （认证权限）
语义理解 （服务号、认证权限）
获取微信服务器IP列表 （初级权限）

##4、被动接口方法

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文件内方法说明
image($mediaid) 设置图片型消息，参数：图片的media_id
Message($msg = '',$append = false) 设置发送的消息（一般不需要调用这个方法）
transfer_customer_service($customer_account = '') 转接多客服，如不指定客服可不提供参数，参数：指定客服的账号
reply() 将以上已经设置好的消息，回复给微信服务器

##5、主动接口方法:

checkAuth($appid,$appsecret,$token) 此处传入公众后台高级接口提供的appid和appsecret, 或者手动指定$token为access_token。函数将返回access_token操作令牌
resetAuth($appid='') 删除验证数据
resetJsTicket($appid='') 删除JSAPI授权TICKET
getJsTicket($appid='',$jsapi_ticket='') 获取JSAPI授权TICKET
getJsSign($url, $timeStamp, $nonceStr, $appid='') 获取JsApi使用签名
createMenu($data) 创建菜单 $data菜单结构详见 自定义菜单创建接口
getServerIp() 获取微信服务器IP地址列表返回数组array('127.0.0.1','127.0.0.1')
getMenu() 获取菜单
deleteMenu() 删除菜单
uploadMedia($data, $type) 上传多媒体文件(注意上传大文件时可能需要先调用 set_time_limit(0) 避免超时)
getMedia() 获取接收到的音频、视频媒体文件
uploadMpVideo($data) 上传视频素材，当需要群发视频时，必须使用此方法得到的MediaID，否则无法显示
uploadArticles($data) 上传图文消息素材
sendMassMessage($data) 高级群发消息
sendGroupMassMessage($data) 高级群发消息（全体或分组群发）
deleteMassMessage($msg_id) 删除群发图文消息
previewMassMessage($data) 预览群发消息
queryMassMessage($msg_id) 查询群发消息发送状态
getQRCode($scene_id,$type=0,$expire=1800) 获取推广二维码ticket字串
getQRUrl($ticket) 获取二维码图片地址
getShortUrl($long_url) 长链接转短链接接口
getUserList($next_openid) 批量获取关注用户列表
getUserInfo($openid) 获取关注者详细信息
updateUserRemark($openid,$remark) 设置用户备注名
getGroup() 获取用户分组列表
getUserGroup($openid) 获取用户所在分组
createGroup($name) 新增自定分组
updateGroup($groupid,$name) 更改分组名称
updateGroupMembers($groupid,$openid) 移动用户分组
sendCustomMessage($data) 发送客服消息
getOauthRedirect($callback,$state,$scope) 获取网页授权oAuth跳转地址
getOauthAccessToken() 通过回调的code获取网页授权access_token
getOauthRefreshToken($refresh_token) 通过refresh_token对access_token续期
getOauthUserinfo($access_token,$openid) 通过网页授权的access_token获取用户资料
getOauthAuth($access_token,$openid) 检验授权凭证access_token是否有效
getSignature($arrdata,'sha1') 生成签名字串
generateNonceStr($length) 获取随机字串
createPackage($out_trade_no,$body,$total_fee,$notify_url,$spbill_create_ip,$fee_type=1,$bank_type="WX",$input_charset="UTF-8",$time_start="",$time_expire="",$transport_fee="",$product_fee="",$goods_tag="",$attach="") 生成订单package字符串
getPaySign($package, $timeStamp, $nonceStr) 支付签名(paySign)生成方法
checkOrderSignature($orderxml='') 回调通知签名验证
sendPayDeliverNotify($openid,$transid,$out_trade_no,$status=1,$msg='ok') 发货通知
getPayOrder($out_trade_no) 查询订单信息
getAddrSign($url, $timeStamp, $nonceStr, $user_token='') 获取收货地址JS的签名
setTMIndustry($id1,$id2='') 模板消息，设置所属行业
addTemplateMessage($tpl_id) 模板消息，添加消息模板
sendTemplateMessage($data) 发送模板消息
getCustomServiceMessage($data) 获取多客服会话记录
transfer_customer_service($customer_account) 转发多客服消息
getCustomServiceKFlist() 获取多客服客服基本信息
getCustomServiceOnlineKFlist() 获取多客服在线客服接待信息
createKFSession($openid,$kf_account,$text='') 创建指定多客服会话
closeKFSession($openid,$kf_account,$text='') 关闭指定多客服会话
getKFSession($openid) 获取用户会话状态
getKFSessionlist($kf_account) 获取指定客服的会话列表
getKFSessionWait() 获取未接入会话列表
addKFAccount($account,$nickname,$password) 添加客服账号
updateKFAccount($account,$nickname,$password) 修改客服账号信息
deleteKFAccount($account) 删除客服账号
setKFHeadImg($account,$imgfile) 上传客服头像
querySemantic($uid,$query,$category,$latitude=0,$longitude=0,$city="",$region="") 语义理解接口参数含义及返回的json内容请查看 微信语义理解接口
createCard($data) 创建卡券
updateCard($data) 修改卡券
delCard($card_id) 删除卡券
getCardInfo($card_id) 查询卡券详情
getCardColors() 获取颜色列表
getCardLocations() 拉取门店列表
addCardLocations($data) 批量导入门店信息
createCardQrcode($card_id) 生成卡券二维码
consumeCardCode($code) 消耗 code
decryptCardCode($encrypt_code) code 解码
checkCardCode($code) 获取 code 的有效性
getCardIdList($data) 批量查询卡列表
updateCardCode($code,$code_id,$new_code) 更改 code
unavailableCardCode($code) 设置卡券失效**(不可逆)**
modifyCardStock($data) 库存修改
activateMemberCard($data) 激活/绑定会员卡，参数结构请参看卡券开发文档(6.1.1 激活/绑定会员卡)章节
updateMemberCard($data) 会员卡交易，参数结构请参看卡券开发文档(6.1.2 会员卡交易)章节
updateLuckyMoney($code,$balance,$card_id='') 更新红包金额
setCardTestWhiteList($openid=array(),$user=array()) 设置卡券测试白名单

##6、环境 PHP >= 5.4 Laravel >= 5

##7、License This is free software distributed under the terms of the MIT license
感谢 dodgepudding/wechat-php-sdk 和 huanghua581/laravel-wechat-sdk

vin / wechat

Maintainers

Details

README