萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 判斷 AJAX 請求的正確姿勢:HTTP_X_REQUESTED_WITH、偽造防範與現代替代方案

原理:jQuery 等框架自動添加的 Header

主流 JS 框架 (jQuery, Axios, Prototype 等) 發送 AJAX 時會自動加入:

X-Requested-With: XMLHttpRequest

PHP 中對應 $_SERVER['HTTP_X_REQUESTED_WITH'] (HTTP_ + 大寫 + 底線替換連字號)。

基本檢測代碼

<?php
function isAjax(): bool {
    return (!empty($_SERVER['HTTP_X_REQUESTED_WITH']) 
        && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest');
}

// 使用
if (isAjax()) {
    // 返回 JSON
    header('Content-Type: application/json');
    echo json_encode(['status' => 'ok', 'data' => $data]);
    exit;
}

// 普通請求返回 HTML
include 'template.php';
?>

三大局限性 (必須知道)

局限說明影響
可偽造客戶端可任意發送 Header:fetch(url, {headers:{'X-Requested-With':'XMLHttpRequest'}})無法作為安全邊界 (如 CSRF 保護)
iframe 跨域iframe 載入頁面不會自動發送此 Header誤判為非 AJAX
舊版 IE / 原生 XHRIE5/6 不自動發送;原生 new XMLHttpRequest() 需手動 setRequestHeader相容性缺口

更可靠的替代方案

方案一:自定義請求參數 (最簡單、可控)

<?php
// 前端
fetch('/api/data?ajax=1') // 或 POST body 帶 ajax=1

// 後端
function isAjax(): bool {
    return isset($_REQUEST['ajax']); // 或 $_GET/$_POST
}
?>

方案二:Accept 標頭檢查 (RESTful 風格)

<?php
function wantsJson(): bool {
    $accept = $_SERVER['HTTP_ACCEPT'] ?? '';
    // 檢查是否接受 JSON (優先於 text/html)
    return strpos($accept, 'application/json') !== false 
        && (strpos($accept, 'text/html') === false || strpos($accept, 'application/json') < strpos($accept, 'text/html'));
}

// 前端
fetch('/api/data', {headers: {'Accept': 'application/json'}})
?>

方案三:獨立 API 端點 (架構層面解決)

  • /api/users → 只回 JSON,強制 Accept: application/json
  • /users → 回 HTML 頁面
  • 路由層面區分,不需在同一入口判斷

方案四:Content-Type 檢查 (針對 POST/PUT)

<?php
function isJsonRequest(): bool {
    $contentType = $_SERVER['CONTENT_TYPE'] ?? '';
    return str_starts_with($contentType, 'application/json');
}

// 獲取 JSON 原始輸入
$input = json_decode(file_get_contents('php://input'), true);
?>

現代框架實踐

  • Laravel:$request->ajax() (檢查 Header)、$request->wantsJson() (檢查 Accept)、$request->expectsJson() (兩者或)
  • Symfony:$request->isXmlHttpRequest()、$request->getPreferredFormat()
  • Slim/原生:中介軟體根據路由前綴 /api/ 自動設置響應格式

安全提醒

  1. 永遠不要用 AJAX 判斷作為權限檢查依據
  2. CSRF 保護:雙重提交 Cookie + Header、SameSite Cookie、Token 驗證
  3. API 介面:統一用 JWT/Opaque Token 驗證身份,而非依賴 Session + AJAX 判斷
  4. 錯誤處理:AJAX 回傳 JSON 錯誤碼,非 AJAX 回傳錯誤頁面
copyright © 萬盛學電腦網 all rights reserved