### [PHP 服务器异常监控 对接飞书机器人实现实时告警推送教程](https://www.huociguo.com/article/807)

**Published:** 2026-08-19T07:35:12

**Author:** 米了

**Excerpt:** 本文提供一套基于 PHP 的服务器异常监控告警解决方案。通过调用飞书自定义机器人 Webhook 接口，实现 CPU 负载过高、内存溢出、磁盘空间不足及 PHP 致命错误等异常情况的实时推送。教程涵盖签名校验配置、cURL 请求封装、异常捕

本文提供一套基于 PHP 的服务器异常监控告警解决方案。通过调用飞书自定义机器人 Webhook 接口，实现 CPU 负载过高、内存溢出、磁盘空间不足及 PHP 致命错误等异常情况的实时推送。教程涵盖签名校验配置、cURL 请求封装、异常捕获逻辑及定时任务部署，适用于 Linux 环境下的生产服务器监控，帮助运维人员快速响应系统故障。

![](https://api.huociguo.com/wp-content/uploads/2026/08/20260819153448401-1907f9f2b4-1.png "20260819153448401-1907f9f2b4-1")

### 环境准备与飞书机器人配置

在编写 PHP 代码前，需在飞书群聊中创建自定义机器人并获取安全凭证。

1.  **创建机器人**：进入飞书群设置，选择“群机器人” > “添加机器人” > “自定义机器人”。
    
2.  **安全设置**：为保障接口安全，建议开启“签名校验”（Sign Verification）。系统会生成 `Webhook 地址` 和 `签名密钥（Secret）`。
    
3.  **权限配置**：确保机器人拥有发送消息的权限。
    

### PHP 生成飞书签名与请求封装

飞书机器人开启签名校验后，PHP 服务端需生成时间戳与签名才能成功发送消息。以下代码封装了发送逻辑，可直接复用。

```php
<?php
/**
 * 飞书机器人消息推送类
 */
class FeishuNotifier
{
    private $webhookUrl;
    private $secret;

    public function __construct($webhookUrl, $secret)
    {
        $this->webhookUrl = $webhookUrl;
        $this->secret = $secret;
    }

    /**
     * 生成带签名的请求头
     * @return array
     */
    private function generateSign()
    {
        $timestamp = time();
        $stringToSign = $timestamp . "\n" . $this->secret;
        $sign = base64_encode(hash_hmac('sha256', $stringToSign, $this->secret, true));
        return [
            'timestamp' => $timestamp,
            'sign' => $sign
        ];
    }

    /**
     * 发送文本消息
     * @param string $content
     * @return bool
     */
    public function sendText($content)
    {
        $signData = $this->generateSign();
        $postData = json_encode([
            'timestamp' => $signData['timestamp'],
            'sign' => $signData['sign'],
            'msg_type' => 'text',
            'content' => [
                'text' => $content
            ]
        ]);

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $this->webhookUrl);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($ch, CURLOPT_TIMEOUT, 5); // 设置超时时间，防止阻塞
        
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        return $httpCode == 200;
    }
}
```

### 监控指标采集与告警逻辑

根据服务器常见的异常场景，编写监控脚本。以下示例监控磁盘空间与 PHP 错误日志。

#### 1\. 磁盘空间监控

当磁盘使用率超过 90% 时触发告警。

```php
/**
 * 检查磁盘使用率
 * @param string $path 监控路径
 * @param int $threshold 阈值（百分比）
 */
function checkDiskUsage($path = '/', $threshold = 90)
{
    $free = shell_exec('df -h ' . escapeshellarg($path));
    preg_match('/(\d+)%/', $free, $matches);
    $usage = isset($matches[1]) ? (int)$matches[1] : 0;

    if ($usage >= $threshold) {
        return "【服务器告警】磁盘空间不足\n路径：{$path}\n当前使用率：{$usage}%\n阈值：{$threshold}%";
    }
    return null;
}
```

#### 2\. PHP 致命错误监控

监控 PHP 错误日志文件，若检测到新的 Fatal error，立即推送。

```php
/**
 * 检查PHP错误日志
 * @param string $logFile 日志路径
 */
function checkPhpErrors($logFile)
{
    if (!file_exists($logFile)) {
        return null;
    }
    // 读取最后10行，避免日志过大
    $lines = shell_exec("tail -n 10 " . escapeshellarg($logFile));
    
    if (strpos($lines, 'PHP Fatal error') !== false) {
        return "【PHP致命错误】\n日志文件：{$logFile}\n最新错误片段：\n" . substr($lines, -500);
    }
    return null;
}
```

### 整合脚本与定时任务部署

将上述功能整合为一个主执行脚本 `monitor.php`，并通过 Linux Cron Job 实现定时轮询。

```php
<?php
// monitor.php
require 'FeishuNotifier.php';

// 配置信息
$webhook = 'https://open.feishu.cn/open-apis/bot/v2/hook/xxxx-xxxx';
$secret = '你的签名密钥';
$notifier = new FeishuNotifier($webhook, $secret);

$alerts = [];

// 执行监控检查
$diskAlert = checkDiskUsage('/', 90);
if ($diskAlert) {
    $alerts[] = $diskAlert;
}

$phpAlert = checkPhpErrors('/var/log/php-fpm/error.log');
if ($phpAlert) {
    $alerts[] = $phpAlert;
}

// 发送汇总告警
if (!empty($alerts)) {
    $serverIp = $_SERVER['SERVER_ADDR'] ?? gethostname();
    $message = "服务器IP：{$serverIp}\n\n" . implode("\n\n---\n\n", $alerts);
    $notifier->sendText($message);
}
```

**配置 Crontab**

使用 `crontab -e` 命令添加定时任务，建议每分钟执行一次：

```bash
* * * * * /usr/bin/php /path/to/monitor.php >/dev/null 2>&1
```

### 优化建议

1.  **告警频率限制**：为避免告警风暴，可在脚本中加入文件锁（flock）或缓存机制（Redis），限制同一类型告警在 5 分钟内仅发送一次。
    
2.  **多维度监控**：可扩展监控 CPU 负载（`sys_getloadavg()`）、内存使用率（`memory_get_usage()`）及关键服务进程状态。
    
3.  **日志持久化**：将告警记录写入本地数据库或日志文件，便于后续追溯与分析。
    

通过上述方案，即可构建一套低延迟、高可靠的 PHP 服务器异常实时告警系统，有效提升线上服务的稳定性与运维效率。

**Categories:** PHP教程

---