萬盛學電腦網

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

PHP 判斷 AJAX 請求:X-Requested-With 標頭檢測最佳實踐

核心原理

主流 JavaScript 庫(jQuery、Axios、Fetch API 等)在發送 AJAX 請求時,會自動加入標頭:

X-Requested-With: XMLHttpRequest

PHP 透過 $_SERVER['HTTP_X_REQUESTED_WITH'] 即可檢測。

標準實作

<?php
/**
 * 判斷是否為 AJAX 請求
 * @return bool
 */
function isAjax(): bool
{
    return isset($_SERVER['HTTP_X_REQUESTED_WITH'])
        && strcasecmp($_SERVER['HTTP_X_REQUESTED_WITH'], 'XMLHttpRequest') === 0;
}

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

// 非 AJAX:正常渲染頁面
include 'layout.php';
?>

進階:支援自定義標頭、API Token 驗證

<?php
class RequestDetector
{
    public static function isAjax(): bool
    {
        return self::hasHeader('X-Requested-With', 'XMLHttpRequest');
    }

    public static function isApi(): bool
    {
        // API 請求通常帶 Accept: application/json 或自定義標頭
        return self::hasHeader('Accept', 'application/json')
            || self::hasHeader('X-API-Key')
            || self::hasHeader('Authorization', 'Bearer ');
    }

    public static function isPjax(): bool
    {
        return self::hasHeader('X-PJAX');
    }

    public static function wantsJson(): bool
    {
        return self::isAjax() 
            || self::isApi()
            || (isset($_SERVER['HTTP_ACCEPT']) 
                && strpos($_SERVER['HTTP_ACCEPT'], 'application/json') !== false);
    }

    private static function hasHeader(string $header, string $expectedValue = ''): bool
    {
        $serverKey = 'HTTP_' . strtoupper(str_replace('-', '_', $header));
        if (!isset($_SERVER[$serverKey])) return false;
        return $expectedValue === '' || stripos($_SERVER[$serverKey], $expectedValue) !== false;
    }
}

// 統一回應格式
function respond($data, int $status = 200): never
{
    http_response_code($status);
    if (RequestDetector::wantsJson()) {
        header('Content-Type: application/json');
        echo json_encode($data, JSON_UNESCAPED_UNICODE);
    } else {
        // HTML 回應或重導向
        echo $data['html'] ?? 'OK';
    }
    exit;
}
?>

前端配合:確保標頭被發送

jQuery

$.ajax({
    url: '/api/user',
    // 預設會送 X-Requested-With: XMLHttpRequest
});

Axios

// 預設不送 X-Requested-With,需手動加入
axios.defaults.headers.common['X-Requested-With'] = 'XMLHttpRequest';
// 或單次請求
axios.get('/api', { headers: { 'X-Requested-With': 'XMLHttpRequest' }});

Fetch API

fetch('/api', {
    headers: {
        'X-Requested-With': 'XMLHttpRequest',
        'Accept': 'application/json'
    }
});

原生 XMLHttpRequest

const xhr = new XMLHttpRequest();
xhr.open('GET', '/api');
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.send();

常見坑點與解決

最佳實踐總結

  1. 雙重檢測:isAjax() || wantsJson() 覆蓋更多場景
  2. 不可信任:標頭可偽造,權限控制必須用 Session/JWT/OAuth
  3. 統一回應:封裝 respond() 依請求類型自動輸出 JSON/HTML
  4. 文檔化:API 文件明確要求客戶端送 X-Requested-With 或 Accept: application/json

一行 isAjax(),讓控制器同時支援傳統表單提交與現代 AJAX/SPA 介面,是 PHP 專案的標準配置。

copyright © 萬盛學電腦網 all rights reserved
問題原因解決
isAjax() 回傳 false前端未送標頭(Axios/Fetch 預設不送)前端加入標頭,或改用 Accept 檢測
跨域請求無標頭CORS 預檢未允許自定義標頭後端 Access-Control-Allow-Headers 加入 X-Requested-With
反向代理吃掉標頭Nginx/Apache 未轉發proxy_set_header X-Requested-With $http_x_requested_with;
偽造 AJAX 請求攻擊者手動加標頭不可單靠此標頭做權限控制,需配合 CSRF Token、JWT 等