Search by 
hyperf-glory / alert-manager
v0.2
2021-05-08 01:57 UTC
Requires
- php: >=7.3
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.14
- mockery/mockery: ^1.0
- phpstan/phpstan: ^0.12
- phpunit/phpunit: >=7.0
- swoole/ide-helper: dev-master
- swow/swow: dev-develop
- symfony/var-dumper: ^5.1
README
请先阅读 钉钉官方文档
介绍
alert-manager 是一款钉钉机器人消息发送的Hyperf扩展，您可以通过此扩展便捷的发送钉钉消息，进行监控和提醒操作
要求
- php版本:>=7.3
- hyperf版本: hyperf2.1+
安装
composer require hyperf-glory/alert-manager
在hyperf项目中使用
安装成功后执行
php bin/hyperf.php vendor:publish hyperf-glory/alert-manager
会自动将alert.php添加到您项目的配置文件当中
相关配置
钉钉启用开关
(可选)默认为开启
DING_ENABLED=true
钉钉的推送token
- (必选)发送钉钉机器人的token，即在您创建机器人之后的access_token
- 钉钉推送链接:https://oapi.dingtalk.com/robot/send?access_token=you-push-token
DING_TOKEN=you-push-token
多机器人配置
如果想要添加多个机器人，则在ding.php当中添加机器人名字和相关的配置即可
return [ 'default' => [ 'enabled' => env('DING_ENABLED',true), 'token' => env('DING_TOKEN',''), 'ssl_verify' => env('DING_SSL_VERIFY',true), 'secret' => env('DING_SECRET',true), 'options' => [ 'timeout' => env('DING_TIME_OUT', 2.0), ], ], 'other' => [ 'enabled' => env('OTHER_DING_ENABLED',true), 'token' => env('OTHER_DING_TOKEN',''), 'ssl_verify' => env('DING_SSL_VERIFY',true), 'secret' => env('OTHER_DING_SECRET',true), ] ];
钉钉发送的超时时间
- (可选) 默认为2.0秒
DING_TIME_OUT=
是否开启SSL验证
- (可选)默认为开启，关闭请手动设置
DING_SSL_VERIFY=false
开启钉钉安全配置
- (可选)默认为无
DING_SECRET=
使用
发送纯文字消息
ding('我就是我, xxx 是不一样的烟火')
or
ding()->text('我就是我, xxx 是不一样的烟火')
发送过程@其他人或者所有人
make(\HyperfGlory\AlertManager\DingTalk::class)->at(["13888888888"],true) ->text("我就是我,@13888888888 是不一样的烟火")
发送链接类型的消息
$title = "自定义机器人协议"; $text = "群机器人是钉钉群的高级扩展功能。群机器人可以将第三方服务的信息聚合到群聊中，实现自动化的信息同步。例如：通过聚合GitHub，GitLab等源码管理服务，实现源码更新同步；通过聚合Trello，JIRA等项目协调服务，实现项目信息同步。不仅如此，群机器人支持Webhook协议的自定义接入，支持更多可能性，例如：你可将运维报警提醒通过自定义机器人聚合到钉钉群。"; $picUrl = ""; $messageUrl = "https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.Rqyvqo&treeId=257&articleId=105735&docType=1"; make(\HyperfGlory\AlertManager\DingTalk::class)->link($title,$text,$messageUrl,$picUrl)
发送markdown类型的消息
$title = '杭州天气'; $markdown = "#### 杭州天气 \n ". "> 9度，@1825718XXXX 西北风1级，空气良89，相对温度73%\n\n ". "> \n". "> ###### 10点20分发布 [天气](http://www.thinkpage.cn/) "; make(\HyperfGlory\AlertManager\DingTalk::class)->markdown($title,$markdown);
or
ding()->at([],true) ->markdown($title,$markdown)
发送Action类型的消息
发送single类型的消息
$title = "乔布斯 20 年前想打造一间苹果咖啡厅，而它正是 Apple Store 的前身"; $text = " \n". " #### 乔布斯 20 年前想打造的苹果咖啡厅 \n\n". " Apple Store 的设计正从原来满满的科技感走向生活化，而其生活化的走向其实可以追溯到 20 年前苹果一个建立咖啡馆的计划"; make(\HyperfGlory\AlertManager\DingTalk::class)->actionCard($title,$text,1) ->single("阅读全文","https://www.dingtalk.com/") ->send()
发送btns类型的消息
make(\HyperfGlory\AlertManager\DingTalk::class)->actionCard($title,$text,1) ->addButtons("内容不错","https://www.dingtalk.com/") ->addButtons("不感兴趣","https://www.dingtalk.com/") ->send();
发送Feed类型的消息
$messageUrl = "https://mp.weixin.qq.com/s?__biz=MzA4NjMwMTA2Ng==&mid=2650316842&idx=1&sn=60da3ea2b29f1dcc43a7c8e4a7c97a16&scene=2&srcid=09189AnRJEdIiWVaKltFzNTw&from=timeline&isappinstalled=0&key=&ascene=2&uin=&devicetype=android-23&version=26031933&nettype=WIFI"; $picUrl = "https://www.dingtalk.com"; make(\HyperfGlory\AlertManager\DingTalk::class)->feed() ->addLinks('时代的火车向前开',$messageUrl,$picUrl) ->addLinks('时代的火车向前开2',$messageUrl,$picUrl) ->send();
多机器人消息发送
发送纯文字消息
ding('我就是我, xxx 是不一样的烟火','other')
or
ding()->with('other')->text('我就是我, xxx 是不一样的烟火');
通过其他机器人发送其他类型消息
ding()->with('other')->markdown($title,$markdown); ding()->with('other') ->feed() ->addLinks('时代的火车向前开',$messageUrl,$picUrl) ->addLinks('时代的火车向前开2',$messageUrl,$picUrl) ->send();
enjoy :)