关于php:我的-composer-包之钉钉自定义机器人

这是在看了超哥（overtrue）的《LX2 PHP 扩大包实战教程 – 从入门到公布》课程后，入手折腾进去的。不过单元测试和自动化测试还没写，这部分刚学，还在折腾中。

源码地址：OverNaive/DingTalkRobot

Requirement

• PHP >= 7.2.5
• Composer

Installation

composer require overnaive/dingtalkrobot ^1.0

Documents

钉钉官网文档

Usage

<?php
use DingTalkRobot\DingTalkRobot;

// 实例化
$robot = new DingTalkRobot([
    'access_token' => 'access_token_string',
    'secret' => 'secret_string',
]);

// 优雅调用
$result = $robot->message->text
    ->setTextContent('我就是我, 是不一样的烟火 @156xxxx8827')
    ->addAtMobile('156xxxx8827')
    ->send();

// 原生调用
$result = $robot->message
    ->send([
        'msgtype' => 'text',
        'text' => ['content' => '我就是我, 是不一样的烟火 @156xxxx8827',],
        'atMobiles' => ['156xxxx8827'],
        'isAtAll' => false,
    ]);

Example

<?php
use DingTalkRobot\DingTalkRobot;

// 实例化
$robot = new DingTalkRobot([
    'access_token' => 'access_token_string',
    'secret' => 'secret_string',
]);

// text 类型
$result = $robot->message->text
    ->setTextContent('我就是我, 是不一样的烟火 @156xxxx8827')
    ->addAtMobile('156xxxx8827')
    ->addAtMobile('189xxxx8325')
    ->send();

var_dump($result);

// link 类型
$result = $robot->message->link
    ->setTitle('时代的火车向前开')
    ->setText('这个行将公布的新版本，创始人 xx 称它为红树林。而在此之前，每当面临重大降级，产品经理们都会取一个应景的代号，这一次，为什么是红树林')
    ->setMessageUrl('https://www.dingtalk.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')
    ->send();

var_dump($result);

// markdown 类型
$result = $robot->message->markdown
    ->setTitle('杭州天气')
    ->setText("#### 杭州天气 @18150089296 \n> 9 度，西北风 1 级，空气良 89，绝对温度 73%\n> ![screenshot](https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png)\n> ###### 10 点 20 分公布 [天气](https://www.dingtalk.com) \n")
    ->addAtMobile('150XXXXXXXX')
    ->send();

var_dump($result);

// 整体跳转 ActionCard 类型
$result = $robot->message->actionCard
    ->setTitle('乔布斯 20 年前想打造一间苹果咖啡厅，而它正是 Apple Store 的前身')
    ->setText("![screenshot](https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png)
 ### 乔布斯 20 年前想打造的苹果咖啡厅
 Apple Store 的设计正从原来满满的科技感走向生活化，而其生活化的走向其实能够追溯到 20 年前苹果一个建设咖啡馆的打算 ")
    ->addBtn('浏览全文', 'https://www.dingtalk.com/')
    ->verticalBtn()
    ->send();

var_dump($result);

// 独立跳转 ActionCard 类型
$result = $robot->message->actionCard
    ->setTitle('乔布斯 20 年前想打造一间苹果咖啡厅，而它正是 Apple Store 的前身')
    ->setText("![screenshot](https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png)
 ### 乔布斯 20 年前想打造的苹果咖啡厅
 Apple Store 的设计正从原来满满的科技感走向生活化，而其生活化的走向其实能够追溯到 20 年前苹果一个建设咖啡馆的打算 ")
    ->verticalBtn()
    ->addBtn('内容不错', 'https://www.dingtalk.com/')
    ->addBtn('不感兴趣', 'https://www.dingtalk.com/')
    ->send();

var_dump($result);

// FeedCard 类型
$result = $robot->message->feedCard
    ->addLink(
        '时代的火车向前开',
        'https://www.dingtalk.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',
        'https://gw.alicdn.com/tfs/TB1ayl9mpYqK1RjSZLeXXbXppXa-170-62.png'
    )
    ->addLink(
        '时代的火车向前开 2',
        'https://www.dingtalk.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',
        'https://gw.alicdn.com/tfs/TB1ayl9mpYqK1RjSZLeXXbXppXa-170-62.png'
    )
    ->send();

var_dump($result);

Advanced Usage

自定义 Guzzle 客户端

替换 Guzzle 客户端

<?php
use GuzzleHttp\Client;
use GuzzleHttp\HandlerStack;
use GuzzleHttp\Handler\CurlHandler;
use DingTalkRobot\DingTalkRobot;

// 实例化
$robot = new DingTalkRobot([
    'access_token' => 'access_token_string',
    'secret' => 'secret_string',
]);

// 自定义 Handler，以下配置代码来自官网文档
$handler = new CurlHandler();
$stack = HandlerStack::create($handler);
$customClient = new Client(['handler' => $stack]);

// 通过预留办法替换掉 Guzzle 客户端
$message = $robot->message->setHttpClient($customClient);
$result = $message->text
    ->setTextContent('我就是我, 是不一样的烟火 @156xxxx8827')
    ->addAtMobile('156xxxx8827')
    ->send();

配置 Guzzle 客户端

<?php
use GuzzleHttp\HandlerStack;
use GuzzleHttp\Handler\CurlHandler;
use DingTalkRobot\DingTalkRobot;

// 自定义 Handler，以下配置代码来自官网文档
$handler = new CurlHandler();
$stack = HandlerStack::create($handler);

// 实例化，可通过 guzzle_options 来自配置客户端
$robot = new DingTalkRobot([
    'access_token' => 'access_token_string',
    'secret' => 'secret_string',
    'guzzle_options' => [
        'handler' => $stack, // 自定义 Handler
        'timeout' => 10.0, // 设置申请超时工夫
    ],
]);

$result = $robot->message->text
    ->setTextContent('我就是我, 是不一样的烟火 @156xxxx8827')
    ->addAtMobile('156xxxx8827')
    ->send();

实践上通过下面替换 Guzzle 客户端或配置 Handler 来反对协程，尚未测试。

更多 guzzle 配置请查阅：Guzzle Documentation

License

MIT