AddonMpApi

作用

公众号应用微信回复接口控制器基类。

有涉及到与微信公众号对话功能的应用,在该应用的根目录下必须定义一个消息接收&回复的接口类文件——Api.php。而且这个类必须继承自此类,同时定义一个message成员方法,这个成员方法会接收来自application/mp/Api 的消息,开发者需要按照easywechat的标准,返回需回复的内容。


结构

namespace app\common\controller;

abstract class AddonMpApi
{
    /**
     * @param \EasyWeChat\Kernel\Messages\Message $message
     * @param array $params
     * @return mixed
     * Author: fudaoji<fdj@kuryun.cn>
     */
    abstract function message($message, $params = []);
}


可以看到message被定义为抽象方法,因此子类必须定义此类。举个例子,在demo应用中的Api.php,做了一个文本回复的示例:

namespace addons\demo;

use app\common\controller\AddonMpApi;
use EasyWeChat\Kernel\Messages\Text;

class Api extends AddonMpApi
{
    /**
     * 应用微信接口唯一入口,此文件的存在给微信消息和应用搭起了沟通的桥梁
     * @param \EasyWeChat\Kernel\Messages\Message $message
     * @param array $params
     * @return Text|mixed
     * Author: fudaoji<fdj@kuryun.cn>
     */
    public function message($message, $params = [])
    {
        return new Text('应用demo的微信测试回复');
    }
}


其他格式的回复参考easywechat文档即可。