教程三：Wechat库的使用

上一篇教程中我们提供了wechat的php的库,
这里我们简要介绍一个这个库的源码和使用.

这个库的主文件为`Wechat.php`,
其余的几个文件都是为这个文件服务的,
提供加解密,消息拼接等功能.

`Wechat.php`中的一个主要类为`Wechat`,
这个类提供了接收到各种微信消息的回调函数,
例如用户关注本公众号的时候会调用到`Wechat`类的`onSubscribe`函数,
我们就可以继承`Wechat`类,然后复写`onSubscribe`函数,实现自己的回复了.

我们在使用`Wechat`这个类的时候,需要继承`Wechat`实现自己的子类,
以便使用这个类提供的各种消息回调函数.
然后创建这个子类的实例,用于对request请求的处理.

例如:

<font size="4">// 继承Wechat
class TestWechat extends Wechat {
}
// step 1: 创建TestWechat类的实例
$wechat = new TestWechat(array(
    'token' => 'weixin',
    'aeskey' => 'xxx',
    'appid' => 'wx5d1fb434a1652ae8',
    'debug' => true
    ));
// setp 2: 检测消息
$wechat->run();</font>

在创建`TestWechat`实例过程中会调用父类`Wechat`的构造函数,
这里完成了token的验证,以及请求数据的解析和暂存.
下面是对Wechat构造函数的说明.

<font size="4">public function __construct($config=array('token'=>'', 'aeskey'=>'', 'appid'=>'', 'debug' => FALSE)) {
  // 获取创建实例时传进来的阐述
  $token = $config['token'];
  $aeskey = $config['aeskey'];
  $appid = $config['appid'];
  $debug = $config['debug'];

  // 调用token验证函数,如果失败直接退出
  // 无论是验证token还是用户发送消息都会检测token,已提高程序的安全性
  if (!$this->validateSignature($token)) {
    exit('签名验证失败');
  }

  // 检测是否是单纯的token验证请求
  // 如果是   返回echostr并退出
  if ($this->isValidateIncomingConn()) {
    // 网址接入验证
    exit($_GET['echostr']);
  }

  // 如果是用户发送的信息请求,需要验证'HTTP_RAW_POST_DATA'数据
  if (!isset($GLOBALS['HTTP_RAW_POST_DATA'])) {
    exit('缺少数据');
  }

  $this->debug = $debug;
  set_error_handler(array(&$this, 'errorHandler'));
  // 设置错误处理函数，将错误通过文本消息回复显示

  // 检测消息是否加密
  if (isset($_GET['encrypt_type'])) {
    $this->encrypted = $_GET['encrypt_type'] == 'aes';
  }

  // 如果消息加密了,调用函数对消息进行解密
  if ($this->encrypted) {
    $this->msgCryptor = new wxBizMsgCrypt($token, $aeskey, $appid);
  }

  // 将请求消息储存起来备用
  $this->savePostData();
}</font>

之后会调用run()函数,
run函数会检测微信服务器发送过来的消息类型,
然后根据不同的类型,调用Wechat中的对应函数进行处理.
因为我们使用的`TestWechat`集成了`Wechat`,
我们只需要在`TestWechat`中复写一下用到的函数,
就会在接收到相应的消息时调用到我们复写的函数.
这也是我们再上一个帖子中复写`onText`函数的原因.

<font size="4">public function run() {
  switch ($this->getRequest('msgtype')) {
    // 如果消息类型为 event
    case 'event':
      switch ($this->getRequest('event')) {
        // 订阅消息
        case 'subscribe':
          $this->onSubscribe();
          break;
        // 退订消息
        case 'unsubscribe':
          $this->onUnsubscribe();
          break;
        //
        case 'SCAN':
          $this->onScan();
          break;

        case 'LOCATION':
          $this->onEventLocation();
          break;

        case 'CLICK':
          $this->onClick();
          break;

      }

      break;
    // 文本消息
    case 'text':
      $this->onText();
      break;
    // 图片消息
    case 'image':
      $this->onImage();
      break;
    // 位置消息
    case 'location':
      $this->onLocation();
      break;
    // 链接消息
    case 'link':
      $this->onLink();
      break;
    // 语音消息
    case 'voice':
      $this->onVoice();
      break;

    default:
      $this->onUnknown();
      break;

  }
}</font>