ThinkPHP 8.0 可通过自定义控制台命令集成钉钉机器人告警，需配置Webhook地址、封装发送逻辑、定义命令参数并构造JSON请求体，支持定时任务、异常捕获及消息增强（如emoji分级、@提醒、频率限制）。
ThinkPHP 8.0 可以通过自定义控制台命令快速集成钉钉机器人告警，适用于服务器异常、任务失败、定时监控等场景。关键在于封装好钉钉 Webhook 发送逻辑，并在命令中按需触发。
准备钉钉机器人 Webhook
登录钉钉群 → 群设置 → 智能群助手 → 添加机器人 → 选择「自定义」→ 复制 Webhook 地址。注意开启「加签」或「IP 白名单」时需同步配置签名验证或放行服务器出口 IP，否则请求会被拒绝。
- 建议关闭加签（开发阶段），避免时间戳与密钥计算出错
- Webhook 地址形如：
https://oapi.dingtalk.com/robot/send?access_token=xxx - 生产环境建议将 token 存入
.env文件，例如：DINGTALK_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxx
创建发送告警的控制台命令
执行命令生成命令类：php think make:command Notify/DingTalkAlert，然后在 app/command/Notify/DingTalkAlert.php 中编写：
- 在
configure()中定义参数，如--msg、--title、--level=warning - 在
handle()中读取参数，构造 JSON 请求体（推荐使用text或markdown类型） - 用
think\Http或原生cURL发送 POST 请求，设置Content-Type: application/json - 检查响应状态码和钉钉返回的
errcode（0 表示成功）
在定时任务或异常捕获中调用
可在 app/command/Cron/CheckServer.php 等监控命令中直接调用：
立即学习“PHP免费学习笔记（深入）”；
- 运行时触发：
php think notify:ding-taik --msg="CPU 使用率超 90%" --title="服务器告警" --level=critical - 代码内调用：
$this->call('notify:ding-taik', ['--msg' => $message, '--level' => 'error']); - 结合
try-catch在关键任务失败时自动推送，例如队列任务、数据库备份脚本
增强实用性的小技巧
让告警更清晰、可操作：
- 消息中加入服务器主机名、当前时间、错误堆栈片段（截取前 200 字符）
- 不同
--level对应不同颜色 emoji 和标题前缀，如 ⚠️ warning / ❌ error / ✅ success - 支持 @ 某人或所有人：在
text内容末尾添加@138xxxxxx（手机号）或@all - 限制高频发送，例如 5 分钟内相同类型告警只发一次（可用缓存记录 last_send_time）
不复杂但容易忽略的是请求头和 JSON 格式校验——少一个双引号或换行符都会导致钉钉返回 400 错误，调试时建议先用 var_dump 打印最终发送的 JSON 字符串。
