laravel-wechat-notification
这是一个 laravel 框架下基于 laravel-wechat 使用微信消息通知作为 notification 通道的 composer 包,使用前请先熟读 laravel - 消息通知
目前已支持:
- 公众号模板消息
- 小程序模板消息
- 开放平台公众号模板消息
- 开放平台小程序模板消息
- 企业微信消息
- 企业微信开放平台消息
使用方式:
0. 添加 composer 包:
composer require "huo-zi/laravel-wechat-notification"
1. 在继承了 notification
的通知类中可以使用如下方法:
public function via($notifiable)
{
/*
* 支持的via列表
* official_account:公众号
* mini_program:小程序
* open_official_account:开放平台公众号
* open_mini_program:开放平台小程序
* work:企业微信
* open_work:开放平台企业微信
*/
return ['official_account', 'mini_program'];
}
public function toOfficialAccount()
{
return WechatMessage::officialAccount('app_name')->template('templateId')->url($url)->data(['fisrt'=>'...']);
}
public function toMiniProgram()
{
return WechatMessage::miniProgram('app_name')->template($templateId)->formId($formId)->data([
'first' => ''
//
]);
}
public function toOpenOfficialAccount()
{
return WechatMessage::openFlatform($name)->officateAccount($appId, $refreshToken, $accessToken)->template('templateId');
}
// 或使用闭包创建开放平台的公众号对象
public function toOpenOfficialAccount()
{
return WechatMessage::openFlatform($name)->officateAccount(function ($open) {
return $open->officateAccount($appId, $refreshToken, $accessToken);
})->template('templateId');
}
// 或创建好开放平台对象后使用
public function toOpenOfficialAccount()
{
return (new WechatPlatform($openPlatform))->officateAccount($appId, $refreshToken, $accessToken)->template($templateId);
}
public function toOpenMiniProgram()
{
return WechatMessage::openFlatform($name)->miniProgram($appId, $refreshToken, $accessToken)->template($templateId);
}
public function toWork()
{
return WechatMessage::work($name)->message($message)->ofAgent($agentId);
}
public function toOpenWork()
{
return WechatMessage::openWork($name)->work($authCorpId, $permanentCode)->message($message)->ofAgent($agentId);
// 同样也支持创建好开放平台对象后使用及闭包创建work对象
$messenger = (new WechatOpenWork($openWork))->work(function($openWork) {
return $openWork->work($authCorpId, $permanentCode);
});
return $messenger->message($message)->ofAgent($agentid);
}
2. 在使用了 triat
Notifiable
的模型里增加获取对应 openid/userid
的方法:
可以参考官方文档里发送邮件通知时自定义收件人
public function routeNotificationForOfficialAccount($notification)
{
// 返回当前model的公众号openid
return $this->openid;
}
public function routeNotificationForMiniProgram($notification)
{
// 返回当前model的小程序openid
}
public function routeNotificationForOpenOfficialAccount($notification)
{
// 返回对应开放平台公众号用户的openid
}
public function routeNotificationForOpenMiniProgram($notification)
{
// 返回对应开放平台小程序用户的openid
}
public function routeNotificationForWork($notification)
{
// 返回当前model的企业微信userid
return ;
}
public function routeNotificationForOpenWork($notification)
{
// 返回对应开放平台企业用户userid
return ;
}
3. 可参考官方文档:发送通知
使用 Notifiable
特性的 notify
方法可以给用户实例发送通知:
use App\Notifications\WorkNotify;
$user->notify(new WorkNotify(new Text('你好啊~')));
使用 Notification
facade 给多个可接收通知的实体发送通知
Notification::send($users, new WorkNotify(new Markdown('#你好啊~')));
License
Licensed under The MIT License (MIT).
—
Git 地址: laravel-wechat-notification
如果对您有帮助,劳烦点个 Start 谢谢.