飞书机器人消息推送-Hyperf 实现步骤1.安装依赖 composer require guzzlehttp/guzzle Hyperf 自带 hyperf/guzzle，直接用： composer require hyperf/guzzle---2.配置 Webhook 在.env 或 config/autoload/feishu.php 中：// config/autoload/feishu.phpreturn['webhook'=>env('FEISHU_WEBHOOK','https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_TOKEN'),'secret'=>env('FEISHU_SECRET',''),// 如果开启了签名校验];---3.创建消息封装类 app/Service/FeishuBot.php<?phpnamespaceApp\Service;use Hyperf\Guzzle\ClientFactory;use Hyperf\Contract\ConfigInterface;classFeishuBot{privatestring $webhook;privatestring $secret;publicfunction__construct(privateClientFactory $clientFactory,privateConfigInterface $config){$this->webhook=$config->get('feishu.webhook');$this->secret=$config->get('feishu.secret','');}// 发送纯文本publicfunctionsendText(string $text):array{return$this->send(['msg_type'=>'text','content'=>['text'=>$text],]);}// 发送富文本（post 类型）publicfunctionsendRichText(string $title,array $content):array{return$this->send(['msg_type'=>'post','content'=>['post'=>['zh_cn'=>['title'=>$title,'content'=>$content,// content 示例：// [[['tag'=>'text','text'=>'hello'],['tag'=>'a','text'=>'链接','href'=>'https://...']]]],],],]);}// 发送图片（需先上传获取 image_key）publicfunctionsendImage(string $imageKey):array{return$this->send(['msg_type'=>'image','content'=>['image_key'=>$imageKey],]);}// 发送交互卡片publicfunctionsendCard(array $card):array{return$this->send(['msg_type'=>'interactive','card'=>$card,]);}privatefunctionsend(array $payload):array{if($this->secret){[$timestamp,$sign]=$this->sign();$payload['timestamp']=$timestamp;$payload['sign']=$sign;}$client=$this->clientFactory->create(['timeout'=>5]);$response=$client->post($this->webhook,['json'=>$payload]);returnjson_decode($response->getBody()->getContents(),true);}// 签名（飞书安全设置开启时需要）privatefunctionsign():array{$timestamp=(string)time();$str=$timestamp."\n".$this->secret;$sign=base64_encode(hash_hmac('sha256','',$str,true));return[$timestamp,$sign];}}---4.注册到容器（可选，推荐） config/autoload/dependencies.phpreturn[\App\Service\FeishuBot::class=>\App\Service\FeishuBot::class,];---5.使用示例// 在 Controller 或 Command 中注入使用publicfunction__construct(privateFeishuBot $bot){}// 文本$this->bot->sendText('服务器告警：CPU 使用率超过 90%');// 富文本$this->bot->sendRichText('部署通知',[[['tag'=>'text','text'=>'环境：'],['tag'=>'text','text'=>'production','style'=>['bold']],],[['tag'=>'a','text'=>'查看详情','href'=>'https://your-ci.com/build/123'],],]);---关键点汇总 ┌──────────────┬───────────────────────────────────────────────┐ │ 要点 │ 说明 │ ├──────────────┼───────────────────────────────────────────────┤ │ Webhook 地址 │ 飞书群 → 设置 → 机器人 → 添加自定义机器人获取 │ ├──────────────┼───────────────────────────────────────────────┤ │ 签名校验 │ 开启后必须带 timestamp+sign，否则403│ ├──────────────┼───────────────────────────────────────────────┤ │ 图片消息 │ image_key 需通过飞书上传图片 API 预先获取 │ ├──────────────┼───────────────────────────────────────────────┤ │ 频率限制 │ 同一机器人5次/秒，100次/分钟 │ ├──────────────┼───────────────────────────────────────────────┤ │ 超时设置 │ Guzzle timeout 建议3-5s，避免阻塞协程 │ └──────────────┴───────────────────────────────────────────────┘
