esd/ding-plugin

esd/ding-plugin

0.2 2019-06-19 07:59 UTC

Requires

• ext-curl: *
• esd/aop-plugin: ~0.1
• esd/esd-core: ~0.1
• esd/saber-plugin: ~0.1

Requires (Dev)

• esd/esd-co-server: ~0.1

MIT

• qiuapeng921

README

钉钉扩展包，当前只封装了 hook 功能

针对项目异常报错，通知钉钉群

安装

$ composer require esd/ding-plugin -vvv

配置参数

application-local.yml 中按需增加配置
ding:
  token: #钉钉群机器人token

添加 DingPlugin 插件

app/Application 的 main 中添加插件

 public static function main()
  {
    $application = new GoApplication();
    $application->addPlug(new DingPlugin());
    $application->run();
  }

通用响应

使用

1. 生成钉钉对象

   在开始操作之前需要获取一个实例，程序中使用以下方式获取实例
    use GetDing;

2. 发送文本消息

   /**
    * 发送文本消息
    * @param string $content 消息内容
    * @param array $mobiles 被@人的手机号(在content里添加@人的手机号)
    * @param bool $isAtAll @所有人时：true，否则为：false
    * @return array
    */
   $this->sendText($content, $mobiles = [], $isAtAll = false)
   

3. 发送链接消息

   /**
    * 发送链接消息
    * @param string $title 消息标题
    * @param string $text 消息内容。如果太长只会部分展示
    * @param string $messageUrl 点击消息跳转的URL
    * @param string $picUrl 图片URL
    * @return array
    */
   $this->sendLink($title, $text, $messageUrl, $picUrl = '')
   

4. 发送Markdown消息

    /**
    * 发送Markdown消息
    * @param string $title 首屏会话透出的展示内容
    * @param string $text markdown格式的消息
    * @param array $mobiles 被@人的手机号(在content里添加@人的手机号)
    * @param bool $isAtAll @所有人时：true，否则为：false
    * @return array
    */
   $this->sendMarkdown($title, $text, $mobiles = [], $isAtAll = false)
   

5. 发送ActionCard

    /**
     * 发送ActionCard
     * @param string $title 首屏会话透出的展示内容
     * @param string $text markdown格式的消息
     * @param array $btns 按钮，每个元素包含 title(按钮方案)、actionURL(点击按钮触发的URL)
     * @param int $btnOrientation 0-按钮竖直排列，1-按钮横向排列
     * @param int $hideAvatar 0-正常发消息者头像，1-隐藏发消息者头像
     * @return array
     */
   $this->sendActionCard($title, $text, $btns = [], $btnOrientation = 0, $hideAvatar = 0)
   

6. 发送FeedCard

    /**
     * 发送FeedCard
     * @param array $links 链接，每个元素包含 title(单条信息文本)、messageURL(点击单条信息到跳转链接)、picURL(单条信息后面图片的URL)
     * @return array
     */
   $this->sendFeedCard($links=[])
   

参考项目

1. 钉钉开发文档-自定义机器人

License

The MIT License (MIT). Please see License File for more information.