微信公众平台 PHP SDK
介绍
简单的微信公众平台 PHP SDK ,通过调用相应的接口,使你可以轻松地开发微信 App 。测试方法如下:
Clone 或下载项目源码,上传至服务器。
进入微信公众平台,高级功能,开启开发模式,并设置接口配置信息。修改
URL为/example/server.php的实际位置,修改Token为weixin(可自行在/example/server.php中更改)。向你的微信公众号发送消息并测试吧!
安装方法
composer
composer require iamfat/wechat dev-master用法
服务端
直接浏览 /example/server.php 了解基本用法,以下为详细说明。
通过继承 Wechat 类进行扩展,通过重写 onSubscribe() 等方法响应关注等请求:
class MyWechat extends \Wechat\Server {
protected function onSubscribe() {} // 用户关注
protected function onUnsubscribe() {} // 用户取消关注
protected function onText() {
// 收到文本消息时触发,此处为响应代码
}
protected function onImage() {} // 收到图片消息
protected function onLocation() {} // 收到地理位置消息
protected function onLink() {} // 收到链接消息
protected function onUnknown() {} // 收到未知类型消息
}使用 getRequest() 可以获取本次请求中的参数(不区分大小写):
$this->getRequest();
// 无参数时,返回包含所有参数的数组
$this->getRequest('msgtype');
// 有参数且参数存在时,返回该参数的值
$this->getRequest('ghost');
// 有参数但参数不存在时,返回 NULL所有请求均包含:
ToUserName 接收方帐号(该公众号ID)
FromUserName 发送方帐号(代表用户的唯一标识)
CreateTime 消息创建时间(时间戳)
MsgId 消息ID(64位整型)
文本消息请求:
MsgType text
Content 文本消息内容
图片消息请求:
MsgType image
PicUrl 图片链接
地理位置消息请求:
MsgType location
Location_X 地理位置纬度
Location_Y 地理位置经度
Scale 地图缩放大小
Label 地理位置信息
链接消息请求:
MsgType link
Title 消息标题
Description 消息描述
Url 消息链接
事件推送:
MsgType event
Event 事件类型
EventKey 事件 Key 值,与自定义菜单接口中 Key 值对应
其中,事件类型 Event 的值包括以下几种:
subscribe 关注
unsubscribe 取消关注
CLICK 自定义菜单点击事件(未验证)
使用 responseText() 方法回复文本消息:
$this->responseText(
$content, // 消息内容
$funcFlag // 可选参数(默认为0),设为1时星标刚才收到的消息
);使用 responseMusic() 方法回复音乐消息:
$this->responseMusic(
$title, // 音乐标题
$description, // 音乐描述
$musicUrl, // 音乐链接
$hqMusicUrl, // 高质量音乐链接,Wi-Fi 环境下优先使用
$funcFlag // 可选参数,默认为0,设为1时星标刚才收到的消息
);使用 responseNews() 方法回复图文消息:
$this->responseNews(
$items, // 由单条图文消息类型 NewsResponseItem() 组成的数组
$funcFlag // 可选参数,默认为0,设为1时星标刚才收到的消息
)其中单条图文消息类型 NewsResponseItem() 格式如下:
$items[] = new NewsResponseItem(
$title, // 图文消息标题
$description, // 图文消息描述
$picUrl, // 图片链接
$url // 点击图文消息跳转链接
);最后,实例化 MyWechat() 并调用 handleRequest() 方法即可运行。
// $token是你在公众平台设置的 Token
$wechat = new MyWechat($token);
$response = $wechat->handleRequest();
// $response是个返回的对象
// 通过(string)$response强制类型转换能获得返回给公众平台的XML字符串
echo $response;
如果你是使用框架, 希望另行导入$_GET和原始POST数据$GLOBALS['HTTP_RAW_POST_DATA'], handleRequest可以传入参数
$response = $wechat->handleRequest(['get'=>$your_get_data, 'post'=>$your_post_data])单点登录
$oauth = new \Wechat\OAuth($appId, $appSecret);
$openId = $oauth->getOpenId(); // OpenID会存储在`$_SESSION`中, 如果没有的话会自动触发HTTP跳转应用接口
$app = new \Wechat\App($appId, $appSecret);
// 获取`acess_token`
$token = $app->getAccessToken();
// 获取用户信息
$info = $app->getUserInfo($openId);
// 获取二维码数据
$qrdata = $app->getQRCode($sceneId, $permanent); // $permanent 是否是永久场景, 默认为false
// 获取JS相关信息
$js = new \Wechat\JS($app);
$url = 'http://path/to/api';
$package = $js->getSignPackage($url); // 获取签名包
// appId, nonceStr, timestamp, url, signature, rawStringTODO
- 完善文档和注释;
- 完善异常处理;