iamfat/wechat

Composer Support for Netputer Wechat PHP SDK

微信公众平台 PHP SDK

介绍

简单的微信公众平台 PHP SDK ，通过调用相应的接口，使你可以轻松地开发微信 App 。测试方法如下：, _(*1)

1. Clone 或下载项目源码，上传至服务器。, _(*2)

2. 进入微信公众平台，高级功能，开启开发模式，并设置接口配置信息。修改 URL 为 /example/server.php 的实际位置，修改 Token 为 weixin （可自行在 /example/server.php 中更改）。, _(*3)

3. 向你的微信公众号发送消息并测试吧！, _(*4)

安装方法

composer

composer require iamfat/wechat dev-master

用法

服务端

直接浏览 /example/server.php 了解基本用法，以下为详细说明。, _(*5)

通过继承 Wechat 类进行扩展，通过重写 onSubscribe() 等方法响应关注等请求：, _(*6)

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() 可以获取本次请求中的参数（不区分大小写）：, _(*7)

$this->getRequest();
// 无参数时，返回包含所有参数的数组

$this->getRequest('msgtype');
// 有参数且参数存在时，返回该参数的值

$this->getRequest('ghost');
// 有参数但参数不存在时，返回 NULL

所有请求均包含：, _(*8)

ToUserName    接收方帐号（该公众号ID）
FromUserName  发送方帐号（代表用户的唯一标识）
CreateTime    消息创建时间（时间戳）
MsgId         消息ID（64位整型）

文本消息请求：, _(*9)

MsgType  text
Content  文本消息内容

图片消息请求：, _(*10)

MsgType  image
PicUrl   图片链接

地理位置消息请求：, _(*11)

MsgType     location
Location_X  地理位置纬度
Location_Y  地理位置经度
Scale       地图缩放大小
Label       地理位置信息

链接消息请求：, _(*12)

MsgType      link
Title        消息标题
Description  消息描述
Url          消息链接

事件推送：, _(*13)

MsgType   event
Event     事件类型
EventKey  事件 Key 值，与自定义菜单接口中 Key 值对应

其中，事件类型 Event 的值包括以下几种：, _(*14)

subscribe    关注
unsubscribe  取消关注
CLICK        自定义菜单点击事件（未验证）

使用 responseText() 方法回复文本消息：, _(*15)

$this->responseText(
  $content,  // 消息内容
  $funcFlag  // 可选参数（默认为0），设为1时星标刚才收到的消息
);

使用 responseMusic() 方法回复音乐消息：, _(*16)

$this->responseMusic(
  $title,        // 音乐标题
  $description,  // 音乐描述
  $musicUrl,     // 音乐链接
  $hqMusicUrl,   // 高质量音乐链接，Wi-Fi 环境下优先使用
  $funcFlag      // 可选参数，默认为0，设为1时星标刚才收到的消息
);

使用 responseNews() 方法回复图文消息：, _(*17)

$this->responseNews(
  $items,    // 由单条图文消息类型 NewsResponseItem() 组成的数组
  $funcFlag  // 可选参数，默认为0，设为1时星标刚才收到的消息
)

其中单条图文消息类型 NewsResponseItem() 格式如下：, _(*18)

$items[] = new NewsResponseItem(
  $title,        // 图文消息标题
  $description,  // 图文消息描述
  $picUrl,       // 图片链接
  $url           // 点击图文消息跳转链接
);

最后，实例化 MyWechat() 并调用 handleRequest() 方法即可运行。, _(*19)

// $token是你在公众平台设置的 Token
$wechat = new MyWechat($token);

$response = $wechat->handleRequest();   
// $response是个返回的对象
// 通过(string)$response强制类型转换能获得返回给公众平台的XML字符串
echo $response; 

如果你是使用框架, 希望另行导入$_GET和原始POST数据$GLOBALS['HTTP_RAW_POST_DATA'], handleRequest可以传入参数, _(*20)

$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, rawString

// 模板消息发送
$app->sendTemplateMessage($openId, $templateId, $data);
// $data = ['url'=>'xxxx', 'topcolor'=>, 其他的data]

TODO

1. 完善文档和注释；
2. 完善异常处理；