短信发送,微信模版消息,小程序提醒消息,开发的流程基本都是一样的。
如果开发者直接是修改niucloud-admin框架,则消息提醒的类型定义位置在 niucloud\app\dict\notice\notice.php文件中
如果开发者开发一个插件,则消息提醒的类型定义位置在插件的addon\hello_world\app\dict\notice\notice.php文件中
notice.php文件中定义消息提醒类型
return [
'verify_code' => [
'key' => 'verify_code',
'receiver_type' => 1,
'name' => '手机验证码',
'title' => '管理端验证码登录',
'async' => false,
'variable' =>[
'code' => '验证码'
],
],
]
verify_code 用户自己定义的关键词
key 和上面的关键词一样
receiver_type 消息接收者,1表示会员接收,0表示平台用户接收
name 消息类型的名称,参考下图
title 消息的描述,说明,暂时没有使用
async 同步还是异步,这个根据具体的业务场景定义。比如短信验证码,需要返回值,就是同步。比如订单完成消息,这种就是异步。异步消息没有返回值。
variable 消息提醒会用到的所有的变量,开发者定义好变量,使用者可以在模版消息中组合变量和普通文本定义消息内容。这个定义好后,在具体的业务调用的代码中,需要传递实际的数据。
定义消息类型后,会在系统中自动加载
如下图

开发者在第一个步骤中先定义好一个消息提醒类型。在实际的应用中,这种消息提醒可能只发送短信,也可能会同时发送短信,微信模版消息,小程序消息。某种业务场景也可能会发给管理者,而不是会员,比如新客户下单消息。
app\dict\notice\sms.php 消息提醒的短信定义
app\dict\notice\weapp.php 消息提醒的微信小程序订阅消息定义
app\dict\notice\wechat.php 消息提醒的微信模版消息定义
上面三个文件为某个消息提醒类型的具体的实现,比如短信验证码,这个消息提醒只会发送短信,而对于微信模版消息,微信小程序订阅消息都是无意义的。则我们只会在sms.php文件中定义短信验证码的定义
<?php
return [
//手机验证码
'verify_code' => [
'content' => '您的手机验证码{code},请不要轻易告诉其他人'
],
];
sms.php中 verify_code关键字和 notice.php中 verify_code 关键词一致
content 表示消息的具体描述,这个描述会在程序中,配置时可以让用户自己修改(暂时没有实现)

经过上面的定义,消息模版类型就定义好了。相应的界面就会出现。
微信模版消息、小程序订阅消息,与上面的操作是一样的。
上面定义配置好后,就可以通过下面的方法发送消息了
(new NoticeService())->send('member_verify_code', ['code' => $code, 'mobile' => $mobile]);
send方法$key参数表示消息的key, $data参数是数组 前面定义的变量数据
niucloud-admin框架会根据您配置的某个消息类型的定义,循环发送实现的消息端口