IT技术社区_专业开发者平台_最新编程教程与解决方案 -沐辰社区

PHP 怎么飞书通知

wen PHP项目 251

本文目录导读：

PHP 怎么飞书通知

  1. 方式一：自定义机器人 Webhook（最简单）
  2. 方式二：带签名的安全增强版（推荐）
  3. 方式三：使用应用机器人（适合复杂场景）
  4. 方式四：使用官方 SDK（推荐生产环境）
  5. 完整封装类（推荐直接使用）
  6. 常见问题解决
  7. 推荐使用场景

在 PHP 中实现飞书通知，主要有以下几种方式，我会按照从简单到复杂的顺序给你介绍：

自定义机器人 Webhook（最简单）

这是最常用的方式，不需要审核,5分钟就能搞定。

创建机器人

  • 在飞书群中，点击 设置 -> 群机器人 -> 添加机器人 -> 自定义机器人
  • 复制生成的 Webhook 地址（格式类似 https://open.feishu.cn/open-apis/bot/v2/hook/xxxx）

PHP 代码实现

<?php
class FeishuNotifier {
    private $webhookUrl;
    public function __construct($webhookUrl) {
        $this->webhookUrl = $webhookUrl;
    }
    /**
     * 发送文本消息
     */
    public function sendText($content) {
        $data = [
            'msg_type' => 'text',
            'content' => [
                'text' => $content
            ]
        ];
        return $this->send($data);
    }
    /**
     * 发送富文本/卡片消息
     */
    public function sendCard($title, $content) {
        $data = [
            'msg_type' => 'interactive',
            'card' => [
                'header' => [
                    'title' => [
                        'tag' => 'plain_text',
                        'content' => $title
                    ],
                    'template' => 'blue'  // 颜色：blue/green/red/orange
                ],
                'elements' => [
                    [
                        'tag' => 'div',
                        'text' => [
                            'tag' => 'lark_md',
                            'content' => $content
                        ]
                    ]
                ]
            ]
        ];
        return $this->send($data);
    }
    /**
     * 发送消息（带签名验证）
     */
    private function send($data) {
        $payload = json_encode($data, JSON_UNESCAPED_UNICODE);
        $ch = curl_init();
        curl_setopt_array($ch, [
            CURLOPT_URL => $this->webhookUrl,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => $payload,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => [
                'Content-Type: application/json; charset=utf-8'
            ],
            CURLOPT_TIMEOUT => 10
        ]);
        $response = curl_exec($ch);
        $error = curl_error($ch);
        curl_close($ch);
        if ($error) {
            return ['success' => false, 'error' => $error];
        }
        return json_decode($response, true);
    }
}
// 使用示例
$webhookUrl = 'https://open.feishu.cn/open-apis/bot/v2/hook/YOUR_WEBHOOK_URL';
$notifier = new FeishuNotifier($webhookUrl);
// 发送普通文本
$result = $notifier->sendText('Hello PHP! 这是一条测试消息');
// 发送富文本卡片
$result = $notifier->sendCard(
    '系统通知 📢',
    '**重要更新**：\n服务器将于今晚 22:00 进行维护'
);
var_dump($result);

带签名的安全增强版（推荐）

如果你的机器人开启了签名验证,需要加上签名逻辑：

<?php
class FeishuSecureNotifier {
    private $webhookUrl;
    private $secret;  // 机器人的签名密钥
    public function __construct($webhookUrl, $secret) {
        $this->webhookUrl = $webhookUrl;
        $this->secret = $secret;
    }
    /**
     * 生成时间戳和签名
     */
    private function generateSign() {
        $timestamp = time();
        // 拼接签名字符串
        $stringToSign = $timestamp . "\n" . $this->secret;
        // 计算签名（注意：需要与飞书文档一致）
        $sign = base64_encode(hash_hmac('sha256', $stringToSign, '', true));
        return [
            'timestamp' => $timestamp,
            'sign' => $sign
        ];
    }
    public function sendText($content) {
        $sign = $this->generateSign();
        $data = [
            'timestamp' => $sign['timestamp'],  // 签名必须放这里
            'sign' => $sign['sign'],           // 签名必须放这里
            'msg_type' => 'text',
            'content' => [
                'text' => $content
            ]
        ];
        // 发送逻辑同上...
    }
}

使用应用机器人（适合复杂场景）

如果需要更丰富的功能（发送文件、@指定人、获取用户信息等）,需要创建应用：

<?php
class FeishuAppNotifier {
    private $appId;
    private $appSecret;
    private $tenantAccessToken;
    public function __construct($appId, $appSecret) {
        $this->appId = $appId;
        $this->appSecret = $appSecret;
        $this->getToken();
    }
    /**
     * 获取 tenant_access_token
     */
    private function getToken() {
        $url = 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal';
        $data = [
            'app_id' => $this->appId,
            'app_secret' => $this->appSecret
        ];
        $response = $this->request($url, $data);
        if (isset($response['tenant_access_token'])) {
            $this->tenantAccessToken = $response['tenant_access_token'];
        }
    }
    /**
     * 发送消息给用户
     */
    public function sendMessageToUser($openId, $content) {
        $url = 'https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id';
        $data = [
            'receive_id' => $openId,
            'msg_type' => 'text',
            'content' => json_encode([
                'text' => $content
            ])
        ];
        return $this->request($url, $data, true);
    }
    /**
     * 发送消息到群组
     */
    public function sendMessageToChat($chatId, $content) {
        $url = 'https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id';
        $data = [
            'receive_id' => $chatId,
            'msg_type' => 'text',
            'content' => json_encode([
                'text' => $content
            ])
        ];
        return $this->request($url, $data, true);
    }
    /**
     * HTTP 请求封装
     */
    private function request($url, $data, $needToken = false) {
        $headers = ['Content-Type: application/json'];
        if ($needToken && $this->tenantAccessToken) {
            $headers[] = 'Authorization: Bearer ' . $this->tenantAccessToken;
        }
        $ch = curl_init();
        curl_setopt_array($ch, [
            CURLOPT_URL => $url,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => json_encode($data),
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => $headers,
            CURLOPT_TIMEOUT => 15
        ]);
        $response = curl_exec($ch);
        curl_close($ch);
        return json_decode($response, true);
    }
}
// 使用示例
$notifier = new FeishuAppNotifier('your_app_id', 'your_app_secret');
// 发送给用户（需要用户 open_id）
$notifier->sendMessageToUser('ou_123456', '你好，这是一条通知！');
// 发送到群组（需要群组 chat_id）
$notifier->sendMessageToChat('oc_123456', '群组通知：系统更新完成');

使用官方 SDK（推荐生产环境）

<?php
// 使用 Composer 安装官方 SDK：composer require larksuite/oapi-sdk
use Lark\Client;
use Lark\Api\Im\V1;
$client = (new Client('your_app_id', 'your_app_secret'))
    ->setHttpClient(new \GuzzleHttp\Client());
// 发送文本消息
$response = $client->im()->v1()->message()
    ->send([
        'receive_id_type' => 'open_id',
        'receive_id' => 'ou_123456',
        'msg_type' => 'text',
        'content' => json_encode(['text' => 'Hello from PHP!'])
    ]);
// 处理响应
if ($response->isOk()) {
    echo "发送成功";
}

完整封装类（推荐直接使用）

这里给你一个可直接使用的基础封装：

<?php
/**
 * 飞书通知工具类
 */
class FeishuNotifier {
    private static $instance = null;
    private $webhookUrl;
    private $secret = null;
    private function __construct($webhookUrl, $secret = null) {
        $this->webhookUrl = $webhookUrl;
        $this->secret = $secret;
    }
    /**
     * 获取单例实例
     */
    public static function getInstance($webhookUrl, $secret = null) {
        if (self::$instance === null) {
            self::$instance = new self($webhookUrl, $secret);
        }
        return self::$instance;
    }
    /**
     * 发送文本消息
     */
    public function sendText($content) {
        $msg = [
            'msg_type' => 'text',
            'content' => ['text' => $content]
        ];
        return $this->execute($msg);
    }
    /**
     * 发送 Markdown 消息
     */
    public function sendMarkdown($title, $markdownContent) {
        $msg = [
            'msg_type' => 'interactive',
            'card' => [
                'header' => [
                    'title' => [
                        'tag' => 'plain_text',
                        'content' => $title
                    ],
                    'template' => 'blue'
                ],
                'elements' => [
                    [
                        'tag' => 'div',
                        'text' => [
                            'tag' => 'lark_md',
                            'content' => $markdownContent
                        ]
                    ]
                ]
            ]
        ];
        return $this->execute($msg);
    }
    /**
     * 发送图片消息
     */
    public function sendImage($imageKey) {
        $msg = [
            'msg_type' => 'image',
            'content' => ['image_key' => $imageKey]
        ];
        return $this->execute($msg);
    }
    /**
     * 执行发送
     */
    private function execute($data) {
        // 签名处理
        if ($this->secret) {
            $timestamp = time();
            $sign = base64_encode(hash_hmac(
                'sha256', 
                $timestamp . "\n" . $this->secret, 
                '', 
                true
            ));
            $data['timestamp'] = $timestamp;
            $data['sign'] = $sign;
        }
        $result = $this->postJson($this->webhookUrl, $data);
        if ($result['code'] === 0) {
            return ['success' => true, 'data' => $result];
        }
        return ['success' => false, 'error' => $result['msg'] ?? 'unknown error'];
    }
    /**
     * POST JSON 请求
     */
    private function postJson($url, $data) {
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Content-Type: application/json; charset=utf-8'
        ]);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 5);
        $response = curl_exec($ch);
        curl_close($ch);
        return json_decode($response, true);
    }
}
// 使用方式（简洁版）
$webhook = 'https://open.feishu.cn/open-apis/bot/v2/hook/xxxx';
$secret = 'your_secret_if_enabled';
$notifier = FeishuNotifier::getInstance($webhook, $secret);
// 发送普通文本
$notifier->sendText('服务器部署完成 ✅');
// 发送 Markdown 格式
$notifier->sendMarkdown(
    '🎉 发布通知', 
    "**版本：** v1.2.3\n**状态：** 发布成功\n**环境：** 生产环境"
);

常见问题解决

报错 "invalid sign"

  • 检查签名算法是否与飞书官方文档一致
  • 确认时间戳是否为服务器当前时间

消息发送成功但没收到

  • 检查机器人是否被群主禁言
  • 确认消息格式是否正确（尤其是 JSON 编码）

中文乱码

  • 确保使用 json_encode($data, JSON_UNESCAPED_UNICODE)
  • 确认 Content-Type 包含 charset=utf-8

超时问题

  • 增加 CURLOPT_TIMEOUT
  • 使用异步方式发送（如队列）

推荐使用场景

  • 系统监控通知：服务器宕机、CPU 过高时推送
  • 业务告警：订单异常、支付失败等
  • CI/CD 通知：构建成功/失败推送
  • 定时任务提醒：定时执行的业务需要关注时

选择建议：

  • 简单通知 → 用自定义机器人 Webhook
  • 需要安全性 → 用签名版
  • 复杂功能 → 用飞书应用 + 官方 SDK

有问题随时问我！

版权声明：NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 NBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 CBA直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 足球直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播 英超直播

上一篇PHP 怎么排班通知

下一篇PHP 怎么企业微信通知

相关文章

抱歉，评论功能暂时关闭!

友情链接攻略窝 · 礼包窝 · 配置窝 · 换算窝 · 算法窝 · 查文窝 · 手册窝 · 问答窝 · 全文搜 · 手册库
相关站点礼包窝 · 查文窝