PHPackages                             vinstone/dingtalk-notice - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. vinstone/dingtalk-notice

ActiveLibrary[Mail & Notifications](/categories/mail)

vinstone/dingtalk-notice
========================

DingTalk Robot Message Notification

1.0.0(3y ago)03MITPHPPHP >=7.0

Since Aug 31Pushed 3y ago1 watchersCompare

[ Source](https://github.com/vinstone/dingtalk-notice)[ Packagist](https://packagist.org/packages/vinstone/dingtalk-notice)[ RSS](/packages/vinstone-dingtalk-notice/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

钉钉群自定义机器人消息通知laravel扩展包
=======================

[](#钉钉群自定义机器人消息通知laravel扩展包)

### 机器人接入方式请先阅读 [钉钉官方文档](https://open.dingtalk.com/document/group/custom-robot-access)

[](#机器人接入方式请先阅读-钉钉官方文档)

介绍
==

[](#介绍)

dingtalk-notie 是钉钉群自定义机器人消息通知的Laravel扩展包，您可以通过集成此扩展包到项目里实现快捷的消息通知

要求
==

[](#要求)

- php版本:>=7.0
- laravel版本: Laravel5.5+

安装
==

[](#安装)

#### 推荐使用 composer 进行安装：

[](#推荐使用-composer-进行安装)

```
composer require vinstone/dingtalk-notice
```

Laravel
=======

[](#laravel)

#### Laravel 5.5+ 已经实现了扩展包发现机制，您不需要进行额外的加载操作，执行以下命令会自动发布配置文件`dingtalk.php`到您项目的配置文件当中

[](#laravel-55-已经实现了扩展包发现机制您不需要进行额外的加载操作执行以下命令会自动发布配置文件dingtalkphp到您项目的配置文件当中)

```
php artisan vendor:publish --provider="DingTalkNotice\Providers\DingTalkNoticeProvider"
```

Lumen
=====

[](#lumen)

#### Lumen 并未移植扩展包自动发现机制，所以需要手动加载扩展包并复制配置文件。

[](#lumen-并未移植扩展包自动发现机制所以需要手动加载扩展包并复制配置文件)

#### 打开配置文件 bootstrap/app.php 并在大约 81 行左右添加如下内容：

[](#打开配置文件-bootstrapappphp-并在大约-81-行左右添加如下内容)

```
$app->register(DingTalkNotice\Providers\DingTalkNoticeProvider::class);
```

#### 将 vendor/vinstone/dingtalk-notice/config/dingtalk.php 复制到您项目配置文件目录config下

[](#将-vendorvinstonedingtalk-noticeconfigdingtalkphp-复制到您项目配置文件目录config下)

非 Laravel/Lumen 框架
==================

[](#非-laravellumen-框架)

#### 无需考虑加载问题，请使用全局函数 \\dingtalk() 或直接创建 \\DingTalkNotice\\Dingtalk 实例来发送消息

[](#无需考虑加载问题请使用全局函数-dingtalk-或直接创建-dingtalknoticedingtalk-实例来发送消息)

配置
==

[](#配置)

打开配置文件 config/dingtalk.php，按如下格式进行配置

```
return [
    // 默认配置
    'default' => [
        // 机器人启用开关
        'enabled' => env('DINGTALK_ENABLED',true),
        // 创建机器人时获取的access_token
        'access_token' => env('DINGTALK_ACCESS_TOKEN',''),
        // 超时时间
        'timeout' => env('DINGTALK_TIMEOUT',2.0),
        // 是否启用SSL验证
        'ssl_verify' => env('DINGTALK_SSL_VERIFY',true),
        // 加签密钥
        'secret' => env('DINGTALK_SECRET',''),
    ],

    // 多机器人配置
    'log' => [
        // 机器人启用开关
        'enabled' => env('LOG_DINGTALK_ENABLED',true),
        // 创建机器人时获取的access_token
        'access_token' => env('LOG_DINGTALK_ACCESS_TOKEN',''),
        // 超时时间
        'timeout' => env('LOG_DINGTALK_TIMEOUT',2.0),
        // 是否启用SSL验证
        'ssl_verify' => env('LOG_DINGTALK_SSL_VERIFY',true),
        // 加签密钥
        'secret' => env('LOG_DINGTALK_SECRET',''),
    ]
];
```

使用方法
====

[](#使用方法)

文本类型消息
------

[](#文本类型消息)

```
use DingTalkNotice\Messages\Text;

$message = new Text('我就是我, @XXX 是不一样的烟火');
```

Link类型消息
--------

[](#link类型消息)

```
use DingTalkNotice\Messages\Link;

$message = new Link('时代的火车向前开', '每当面临重大升级，产品经理们都会取一个应景的代号', 'https://open.dingtalk.com/document/group/custom-robot-access', 'https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png', true);

// 重点：点击消息跳转的URL，PC端默认在侧边栏打开，如需在浏览器打开，请设置第 5 个参数为 false
```

Markdown类型消息
------------

[](#markdown类型消息)

```
use DingTalkNotice\Messages\Markdown;

$message = new Markdown('杭州天气', '"#### 杭州天气 @150XXXXXXXX \n > 9度，西北风1级，空气良89，相对温度73%\n');
```

ActionCard类型消息
--------------

[](#actioncard类型消息)

```
use DingTalkNotice\Messages\ActionCard;

$message = new ActionCard('乔布斯20年前想打造一间苹果咖啡厅', '![screenshot](https://gw.alicdn.com/tfs/TB1ut3xxbsrBKNjSZFpXXcXhFXa-846-786.png)
 ### 乔布斯 20 年前想打造的苹果咖啡厅');
```

### 整体跳转类型

[](#整体跳转类型)

```
$message->single('阅读全文', 'https://open.dingtalk.com/document/group/custom-robot-access', true);

// 重点：点击按钮触发的URL，PC端默认在侧边栏打开，如需在浏览器打开，请设置第 3 个参数为 false
```

### 独立跳转类型

[](#独立跳转类型)

```
$message->addButton('内容不错', 'https://www.dingtalk.com/', true);

// 重点：点击按钮触发的URL，PC端默认在侧边栏打开，如需在浏览器打开，请设置第 3 个参数为 false
```

FeedCard类型消息
------------

[](#feedcard类型消息)

```
use DingTalkNotice\Messages\FeedCard;

$message = new FeedCard();
$message->addLink('时代的火车向前开', 'https://www.dingtalk.com/', 'https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png', true);

// 重点：点击单条信息到跳转URL，PC端默认在侧边栏打开，如需在浏览器打开，请设置第 4 个参数为 false
```

消息接收人
=====

[](#消息接收人)

### @其他人

[](#其他人)

```
$message->at(['138xxxxxxx']);
```

### or

[](#or)

```
$message->at('138xxxxxxxx,139xxxxxxxx');
```

### or

[](#or-1)

```
$message->at('138xxxxxxxx');
```

### @所有人

[](#所有人)

```
$message->atAll();
```

消息发送
====

[](#消息发送)

### 容器解析

[](#容器解析)

```
app(DingTalk::class)->setMessage($message)->send();
```

### 辅助函数 dingtalk

[](#辅助函数-dingtalk)

```
dingtalk()->setMessage($message)->send();
```

多机器人消息发送
========

[](#多机器人消息发送)

### 容器解析

[](#容器解析-1)

```
app(DingTalk::class)->other('log')->setMessage($message)->send();
```

### 辅助函数 dingtalk

[](#辅助函数-dingtalk-1)

```
dingtalk()->other('log')->setMessage($message)->send();
```

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1401d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8928b7f9f5d615677dee6630584f356e6d99ddb5cc26103b06ae27bfe11d71ab?d=identicon)[vinstone](/maintainers/vinstone)

---

Top Contributors

[![vinstone](https://avatars.githubusercontent.com/u/88078829?v=4)](https://github.com/vinstone "vinstone (2 commits)")

---

Tags

laraveldingtalkdingdingdingtalk noticedingtalk message

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vinstone-dingtalk-notice/health.svg)

```
[![Health](https://phpackages.com/badges/vinstone-dingtalk-notice/health.svg)](https://phpackages.com/packages/vinstone-dingtalk-notice)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k543.5M2.5k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[guanguans/notify

Push notification SDK(AnPush、Bark、Chanify、DingTalk、Discord、Gitter、GoogleChat、IGot、Lark、Mattermost、MicrosoftTeams、NotifyX、NowPush、Ntfy、Push、Pushback、PushBullet、PushDeer、PushMe、Pushover、PushPlus、QQ、RocketChat、ServerChan、ShowdocPush、SimplePush、Slack、Telegram、WeWork、WPush、XiZhi、YiFengChuanHua、ZohoCliq、ZohoCliqWebHook、Zulip).

687114.3k8](/packages/guanguans-notify)[erag/laravel-disposable-email

A Laravel package to detect and block disposable email addresses.

254168.5k](/packages/erag-laravel-disposable-email)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)