本文详解如何通过 curl 替代 fopen 实现 telegram bot api 的健壮调用，并在前端准确捕获服务端错误（如无效 token、非法 chat_id），避免 ajax 的 success 回调误判失败请求。
本文详解如何通过 curl 替代 fopen 实现 telegram bot api 的健壮调用，并在前端准确捕获服务端错误（如无效 token、非法 chat_id），避免 ajax 的 success 回调误判失败请求。
在当前代码中，fopen() 被用于向 Telegram API 发起 GET 请求，但该方式存在根本性缺陷：它仅检测网络连接是否成功（如 DNS 解析、TCP 建立），完全忽略 HTTP 状态码与 API 实际响应内容。即使 Token 错误（如返回 {"ok":false,"error_code":401,"description":"Unauthorized"}），fopen 仍可能返回资源句柄，导致 jQuery 的 success 回调被错误触发。
要真正实现错误感知，必须：
- 使用 cURL 发起请求：支持完整 HTTP 协议交互，可获取状态码、响应头与响应体；
- 解析 API 返回的 JSON 响应：Telegram Bot API 明确约定："ok": true 表示业务成功，否则为失败；
- 主动设置 HTTP 状态码：服务端在失败时返回 500 Internal Server Error，使前端 error 回调被正确触发；
- 统一输出结构化 JSON：便于前后端约定通信协议。
以下是优化后的 js/send_to_telegram.php 完整实现：
<?php
header('Content-Type: application/json; charset=utf-8');
$token = "5306003979:AAEPK2NhlxW";
$chat_id = "497358";
$txt = !empty($_POST['text']) ? htmlspecialchars(trim($_POST['text'])) : '';
// 防御性检查：确保必要参数存在且非空
if (empty($txt)) {
http_response_code(400);
echo json_encode(['message' => 'Text is required']);
exit;
}
function telegramPost($url, $data) {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($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);
if ($response === false) {
throw new Exception('cURL error: ' . curl_error($ch));
}
return [
'http_code' => $httpCode,
'body' => json_decode($response, true)
];
}
try {
$apiUrl = "https://api.telegram.org/bot{$token}/sendMessage";
$result = telegramPost($apiUrl, [
'chat_id' => $chat_id,
'text' => $txt,
'parse_mode' => 'html'
]);
// 检查 Telegram API 是否返回 ok=true
if (!empty($result['body']['ok']) && $result['body']['ok'] === true) {
http_response_code(200);
echo json_encode(['message' => 'ok', 'data' => $result['body']]);
} else {
// Telegram API 明确返回错误（如 401 Unauthorized, 400 Bad Request）
$errorCode = $result['body']['error_code'] ?? 500;
$description = $result['body']['description'] ?? 'Telegram API error';
http_response_code($errorCode >= 400 && $errorCode < 600 ? $errorCode : 500);
echo json_encode([
'message' => 'Telegram send failed',
'error_code' => $errorCode,
'description' => $description
]);
}
} catch (Exception $e) {
http_response_code(500);
echo json_encode([
'message' => 'Server internal error',
'error' => $e->getMessage()
]);
}前端 JavaScript 无需修改逻辑，但可增强错误反馈的实用性：
立即学习“PHP免费学习笔记（深入）”；
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";
console.log("Success:", result);
},
error: function (jqXHR, textStatus, errorThrown) {
errormodal.style.display = "block";
console.error("AJAX Error:", {
status: jqXHR.status,
statusText: jqXHR.statusText,
responseJSON: jqXHR.responseJSON
});
}
});
});✅ 关键改进点总结：
- ✅ 使用 curl 替代 fopen，真实获取 HTTP 状态码与响应体；
- ✅ 主动校验 Telegram API 的 {"ok": false, ...} 结构，而非依赖网络层成功；
- ✅ 失败时调用 http_response_code(500)（或更精确的状态码），确保触发 jQuery 的 error 回调；
- ✅ 增加输入校验、异常捕获与超时控制，提升鲁棒性；
- ✅ 输出统一 JSON 格式，便于调试与后续扩展（如添加重试、日志、限流等）。
⚠️ 注意事项：
- 生产环境中务必启用 CURLOPT_SSL_VERIFYPEER => true 并配置可信 CA 证书；
- Token 和 chat_id 属于敏感信息，不应硬编码在 PHP 文件中，建议通过环境变量或配置中心管理；
- Telegram 对频繁请求有限制（如每秒最多 30 条），需在业务层添加防刷与队列机制。
