作用
公众号应用微信回复接口控制器基类。
有涉及到与微信公众号对话功能的应用,在该应用的根目录下必须定义一个消息接收&回复的接口类文件——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文档即可。