如何在 PHP 处理 Telegram 消息发送失败时正确返回错误状态-php教程-PHP中文网

如何在 PHP 处理 Telegram 消息发送失败时正确返回错误状态

本文详解如何通过 cURL 替代 fopen 发起 Telegram Bot API 请求，并在 PHP 层主动校验响应结果、返回标准 HTTP 错误码，从而让前端 jQuery AJAX 的 error 回调真正触发，实现可靠错误处理。

本文详解如何通过 curl 替代 fopen 发起 telegram bot api 请求，并在 php 层主动校验响应结果、返回标准 http 错误码，从而让前端 jquery ajax 的 `error` 回调真正触发，实现可靠错误处理。

在当前代码中，使用 fopen() 向 Telegram API 发起 GET 请求存在两个根本性缺陷：一是它无法获取真实的 HTTP 状态码（如 401 Unauthorized 表示 token 错误），二是即使 API 返回 JSON 错误响应（如 {"ok":false,"error_code":401,"description":"Unauthorized"}），fopen 仍会视为“成功打开流”，导致 jQuery 的 success 回调被触发，掩盖了实际失败。

要实现真正的错误捕获，必须满足两个条件：
✅ 使用支持状态码获取的 HTTP 客户端（推荐 cURL）；
✅ 在 PHP 中解析 API 响应体，根据 {"ok": false} 显式设置 HTTP 状态码（如 http_response_code(500)），使 AJAX 的 error 回调可被触发。

以下是优化后的完整方案：

1. 修改 js/send_to_telegram.php：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<?php header('Content-Type: application/json; charset=utf-8');

$token = "5306003979:AAEPK2NhlxW";
$chat_id = "497358";
$txt = isset($_POST['text']) ? htmlspecialchars(trim($_POST['text'])) : '';

// 防御性检查
if (empty($txt)) {
    http_response_code(400);
    echo json_encode(['message' => 'Text is required']);
    exit;
}

function telegramPost($token, $endpoint, $data) {
    $url = "https://api.telegram.org/bot{$token}/{$endpoint}";
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 生产环境建议设为 true 并配置 CA

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    return [
        'http_code' => $httpCode,
        'body'      => $response ? json_decode($response, true) : null
    ];
}

$result = telegramPost($token, 'sendMessage', [
    'chat_id' => $chat_id,
    'text'    => $txt,
    'parse_mode' => 'html'
]);

// 核心判断：仅当 API 返回 ok=true 且 HTTP 状态码为 200 才视为成功
if ($result['body'] && isset($result['body']['ok']) && $result['body']['ok'] === true) {
    http_response_code(200);
    echo json_encode(['message' => 'ok']);
} else {
    // 记录错误日志（生产环境强烈建议）
    error_log('Telegram API Error: ' . json_encode($result));

    // 根据常见错误码返回更精确的状态码
    $errorCode = $result['body']['error_code'] ?? 500;
    $httpStatus = in_array($errorCode, [400, 401, 403, 404]) ? $errorCode : 500;
    http_response_code($httpStatus);

    echo json_encode([
        'message' => $result['body']['description'] ?? 'Failed to send message via Telegram'
    ]);
}

2. 前端保持不变（但 now works correctly）：
你的原始 jQuery 代码已具备正确结构，无需修改——只要 PHP 正确返回非 2xx 状态码，error 回调就会被触发：

jQuery("form").submit(function (e) {
    e.preventDefault(); // 阻止默认提交
    var form_data = jQuery(this).serialize();
    jQuery.ajax({
        type: "POST",
        url: "js/send_to_telegram.php",
        data: form_data,
        dataType: "json",
        success: function (result) {
            donemodal.style.display = "block";
        },
        error: function (jqXHR, textStatus, errorThrown) {
            console.error('AJAX Error:', jqXHR.status, errorThrown);
            errormodal.style.display = "block";
        }
    });
});

关键注意事项：
⚠️ 永远不要在 URL 中拼接敏感参数（如 token）发起 GET 请求 —— 易被日志、代理或浏览器历史泄露；
⚠️ curl_setopt(CURLOPT_SSL_VERIFYPEER, false) 仅用于调试，生产环境必须启用证书验证；
⚠️ 建议对 $txt 做长度限制（Telegram 单消息上限 4096 字符）并过滤非法 HTML 标签；
⚠️ 添加服务器端日志记录（如 error_log()）是排查 token 失效、网络超时等问题的必备手段。

通过以上改造，当 token 错误、chat_id 无效或网络异常时，PHP 将主动返回 500 或对应 HTTP 错误码，前端 error 回调将精准响应，真正实现端到端的错误可观测性与用户体验保障。