交互响应控制器

如果在创建插件的时候勾选了是否需要响应规则，则插件创建成功后会自动生成一个RespondController，在RespondController.class.php中会有一个自动生成的wechat方法用于接收微信端消息并进行响应。

例如聊天机器人插件，在创建的时候勾选了是否需要响应规则，然后在后台响应规则处设置了一个触发关键词聊天，那么当用户在微信端发送消息“聊天”的时候，用户的此条微信消息会被分发到聊天机器人插件的RespondController.class.php中的wechat方法进行响应。我们可以这样来进行响应：

  1. <?php 
  3. namespace Addons\IdouChat\Controller;
  4. use Mp\Controller\ApiController;
  6. /**
  7.  * 聊天机器人响应控制器
  8.  * @author 艾逗笔
  9.  */
  10. class RespondController extends ApiController {
  12.     /**
  13.      * 微信交互
  14.      * @param $message array 微信消息数组
  15.      * @author 艾逗笔<765532665@qq.com>
  16.      */
  17.     public function wechat($message = array()) {
  18.         $settings = get_addon_settings('IdouChat');
  19.         $settings['enter_tip'] || $settings['enter_tip'] = '你想聊点什么呢';
  20.         $settings['keep_time'] || $settings['keep_time'] = 300;
  21.         $settings['exit_keyword'] || $settings['exit_keyword'] = '退出';
  22.         $settings['exit_tip'] || $settings['exit_tip'] = '下次无聊的时候可以再找我聊天哦';
  23.         if (!$settings['api_url'] || !$settings['api_key']) {
  24.             reply_text('机器人聊天接口未填写，暂时不能使用此功能');
  25.             exit();
  26.         }
  27.         if ($this->message['MsgType'] == 'voice') {
  28.             if ($settings['can_voice'] == '1') {
  29.                 $content = $this->message['Recognition'];        // 语音识别，直接开启机器人聊天模式
  30.                 $reply = $this->turingAPI($content);
  31.                 if (is_array($reply)) {
  32.                     return reply_news($reply);
  33.                 } else {
  34.                     return reply_text($reply);
  35.                 }
  36.             }
  37.         } else {
  38.             $content = $this->message['Content'];            // 通过消息上下文机制与机器人展开聊天
  39.             if (!$this->in_context) {
  40.                 $reply = $settings['enter_tip'];
  41.                 $this->begin_context($settings['keep_time']);                    // 开启上下文模式
  42.             } else {
  43.                 if ($content == $settings['exit_keyword']) {
  44.                     $reply = $settings['exit_tip'];
  45.                     $this->end_context();
  46.                 } else {
  47.                     $reply = $this->turingAPI($content);
  48.                     $this->keep_context($settings['keep_time']);                // 保持消息上下文
  49.                 }
  50.             }
  52.             if (is_array($reply)) {
  53.                 return reply_news($reply);
  54.             } else {
  55.                 return reply_text($reply);
  56.             }
  57.         }
  58.     }
  60.     // 图灵机器人
  61.     private function turingAPI($keyword) {
  62.         $settings = get_addon_settings('IdouChat');
  63.         $settings['api_url'] || $settings['api_url'] = '';
  64.         $settings['api_key'] || $settings['api_key'] = '';
  65.         $api_url = $settings['api_url'] . "?key=" . $settings['api_key'] . "&info=" . $keyword;
  67.         $result = file_get_contents ( $api_url );
  68.         $result = json_decode ( $result, true );
  69.         if ($_GET ['format'] == 'test') {
  70.             dump ( '图灵机器人结果：' );
  71.             dump ( $result );
  72.         }
  73.         if ($result ['code'] > 40000 && $result['code'] < 40008) {
  74.             if ($result ['code'] < 40008 && ! empty ( $result ['text'] )) {
  75.                 return '图灵机器人请你注意：' . $result ['text'];
  76.             } else {
  77.                 return false;
  78.             }
  79.         }
  80.         switch ($result ['code']) {
  81.             case '100000' :
  82.                 return $result['text'];
  83.                 break;
  84.             case '200000' :
  85.                 $text = $result ['text'] . ',<a href="' . $result ['url'] . '">点击进入</a>';
  86.                 return $text;
  87.                 break;
  88.             case '301000' :
  89.                 foreach ( $result ['list'] as $info ) {
  90.                     $articles [] = array (
  91.                             'Title' => $info ['name'],
  92.                             'Description' => $info ['author'],
  93.                             'PicUrl' => $info ['icon'],
  94.                             'Url' => $info ['detailurl'] 
  95.                     );
  96.                 }
  97.                 return $articles;
  98.                 break;
  99.             case '302000' :
  100.                 foreach ( $result ['list'] as $info ) {
  101.                     $articles [] = array (
  102.                             'Title' => $info ['article'],
  103.                             'Description' => $info ['source'],
  104.                             'PicUrl' => $info ['icon'],
  105.                             'Url' => $info ['detailurl'] 
  106.                     );
  107.                 }
  108.                 return $articles;
  109.                 break;
  110.             case '304000' :
  111.                 foreach ( $result ['list'] as $info ) {
  112.                     $articles [] = array (
  113.                             'Title' => $info ['name'],
  114.                             'Description' => $info ['count'],
  115.                             'PicUrl' => $info ['icon'],
  116.                             'Url' => $info ['detailurl'] 
  117.                     );
  118.                 }
  119.                 return $articles;
  120.                 break;
  121.             case '305000' :
  122.                 foreach ( $result ['list'] as $info ) {
  123.                     $articles [] = array (
  124.                             'Title' => $info ['start'] . '--' . $info ['terminal'],
  125.                             'Description' => $info ['starttime'] . '--' . $info ['endtime'],
  126.                             'PicUrl' => $info ['icon'],
  127.                             'Url' => $info ['detailurl'] 
  128.                     );
  129.                 }
  130.                 return $articles;
  131.                 break;
  132.             case '306000' :
  133.                 foreach ( $result ['list'] as $info ) {
  134.                     $articles [] = array (
  135.                             'Title' => $info ['flight'] . '--' . $info ['route'],
  136.                             'Description' => $info ['starttime'] . '--' . $info ['endtime'],
  137.                             'PicUrl' => $info ['icon'],
  138.                             'Url' => $info ['detailurl'] 
  139.                     );
  140.                 }
  141.                 return $articles;
  142.                 break;
  143.             case '307000' :
  144.                 foreach ( $result ['list'] as $info ) {
  145.                     $articles [] = array (
  146.                             'Title' => $info ['name'],
  147.                             'Description' => $info ['info'],
  148.                             'PicUrl' => $info ['icon'],
  149.                             'Url' => $info ['detailurl'] 
  150.                     );
  151.                 }
  152.                 return $articles;
  153.                 break;
  154.             case '308000' :
  155.                 foreach ( $result ['list'] as $info ) {
  156.                     $articles [] = array (
  157.                             'Title' => $info ['name'],
  158.                             'Description' => $info ['info'],
  159.                             'PicUrl' => $info ['icon'],
  160.                             'Url' => $info ['detailurl'] 
  161.                     );
  162.                 }
  163.                 return $articles;
  164.                 break;
  165.             case '309000' :
  166.                 foreach ( $result ['list'] as $info ) {
  167.                     $articles [] = array (
  168.                             'Title' => $info ['name'],
  169.                             'Description' => '价格 : ' . $info ['price'] . ' 满意度 : ' . $info ['satisfaction'],
  170.                             'PicUrl' => $info ['icon'],
  171.                             'Url' => $info ['detailurl'] 
  172.                     );
  173.                 }
  174.                 return $articles;
  175.                 break;
  176.             case '310000' :
  177.                 foreach ( $result ['list'] as $info ) {
  178.                     $articles [] = array (
  179.                             'Title' => $info ['number'],
  180.                             'Description' => $info ['info'],
  181.                             'PicUrl' => $info ['icon'],
  182.                             'Url' => $info ['detailurl'] 
  183.                     );
  184.                 }
  185.                 return $articles;
  186.                 break;
  187.             case '311000' :
  188.                 foreach ( $result ['list'] as $info ) {
  189.                     $articles [] = array (
  190.                             'Title' => $info ['name'],
  191.                             'Description' => '价格 : ' . $info ['price'],
  192.                             'PicUrl' => $info ['icon'],
  193.                             'Url' => $info ['detailurl'] 
  194.                     );
  195.                 }
  196.                 return $articles;
  197.                 break;
  198.             case '312000' :
  199.                 foreach ( $result ['list'] as $info ) {
  200.                     $articles [] = array (
  201.                             'Title' => $info ['name'],
  202.                             'Description' => '价格 : ' . $info ['price'],
  203.                             'PicUrl' => $info ['icon'],
  204.                             'Url' => $info ['detailurl'] 
  205.                     );
  206.                 }
  207.                 return $articles;
  208.                 break;
  209.             default :
  210.                 if (empty ( $result ['text'] )) {
  211.                     return false;
  212.                 } else {
  213.                     return $result ['text'];
  214.                 }
  215.         }
  216.         return true;
  217.     }
  218. }

其中，$this->message或者$message数组里面包含了分发到wechat方法的用户消息，包含ToUserName、FromUserName、Content等信息。通过get_addon_settings可以获取插件的配置参数，通过$this->begin_context可以设置消息上下文、通过reply_text可以回复文本消息等。

总而言之。RespondController是用于接收用户通过微信发送来的消息并进行响应的控制器，如果插件的功能需要在微信对话框通过消息的收发来进行交互的话，那么在创建插件的时候就需要选择响应规则，并在微信响应控制器中设计对应的业务逻辑来对用户消息进行响应。