教程三：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>

巴特西

教程三：Wechat库的使用

最新文章

热门文章