萬盛學電腦網

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

PHP 驗證 AJAX 請求來源:HTTP_X_REQUESTED_WITH 標頭檢測與自定義 Header 方案

標準檢測:HTTP_X_REQUESTED_WITH

jQuery、Axios、Fetch(部分)、Prototype 等主流 JS 庫發送 AJAX 時自動加入此標頭:

<?php
// 標準檢測方式
function is_ajax() {
    return isset($_SERVER['HTTP_X_REQUESTED_WITH']) 
        && strtolower($_server['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest';
}

if (is_ajax()) {
    echo json_encode(['status' => 'ok', 'data' => $data]);
    exit;
}

// 非 AJAX 請求正常渲染頁面
include 'page_template.php';

原理:jQuery 內部實作

// jQuery 核心原始碼片段
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');

此為非標準慣例標頭,非 W3C 強制規範,但已成行業事實標準。

自定義 Header 方案(更靈活、可控)

前端:原生 XMLHttpRequest

var xhr = new XMLHttpRequest();
xhr.open('GET', '/api/data');
xhr.setRequestHeader('X-Request-Type', 'ajax');  // 自定義標頭
xhr.send();

前端:jQuery $.ajax()

$.ajax({
    url: '/api/data',
    beforeSend: function(xhr) {
        xhr.setRequestHeader('X-Request-Type', 'ajax');
    },
    success: function(data) {
        $('#result').html(data);
    }
});

前端:Fetch API(現代標準)

fetch('/api/data', {
    method: 'GET',
    headers: {
        'X-Request-Type': 'ajax',
        'Content-Type': 'application/json'
    },
    credentials: 'same-origin'  // 攜帶 Cookie
}).then(res => res.json()).then(data => {
    console.log(data);
});

後端 PHP 驗證自定義標頭

<?php
function is_custom_ajax() {
    // Apache: HTTP_ + 大寫 + 底線替換連字號
    // Nginx + PHP-FPM: 同樣規則
    return isset($_SERVER['HTTP_X_REQUEST_TYPE']) 
        && $_SERVER['HTTP_X_REQUEST_TYPE'] === 'ajax';
}

// 通用檢測函數(支援多種標頭)
function is_ajax_request() {
    $headers = [
        'HTTP_X_REQUESTED_WITH' => 'xmlhttprequest',  // jQuery 標準
        'HTTP_X_REQUEST_TYPE' => 'ajax',               // 自定義
        'HTTP_X_AJAX' => 'true',                       // 另一常見慣例
    ];
    
    foreach ($headers as $server_key => $expected) {
        if (isset($_SERVER[$server_key]) 
            && strtolower($_SERVER[$server_key]) === $expected) {
            return true;
        }
    }
    return false;
}

完整應用範例:同一支 PHP 處理 AJAX 與一般請求

<?php
require 'db.php';

$action = $_POST['action'] ?? $_GET['action'] ?? '';

if ($action === 'get_users') {
    $users = $pdo->query('SELECT id, name, email FROM users')->fetchAll();
    
    if (is_ajax_request()) {
        // AJAX 回傳 JSON
        header('Content-Type: application/json; charset=utf-8');
        echo json_encode(['success' => true, 'data' => $users], JSON_UNESCAPED_UNICODE);
    } else {
        // 一般請求渲染 HTML 片段
        include 'templates/user_list.php';  // 內部使用 $users
    }
    exit;
}

// 頁面完整渲染
include 'templates/layout.php';

注意事項與限制

限制說明對策
可被偽造客戶端可任意發送標頭不可用於安全防護,僅作為區分回應格式依據
非標準標頭非所有 JS 庫/框架自動發送自行在前端統一加入,或用 Accept 標頭判斷
跨域請求CORS 預檢需允許自定義標頭後端 `Access-Control-Allow-Headers: X-Requested-With, X-Request-Type`
代理/負載均衡可能移除/修改標頭檢查代理設定,確保透傳

現代替代方案:Accept 標頭

<?php
function wants_json() {
    $accept = $_SERVER['HTTP_ACCEPT'] ?? '';
    // 檢查是否接受 JSON
    return strpos($accept, 'application/json') !== false 
        || strpos($accept, 'application/vnd.api+json') !== false;
}

// 前端 Fetch 明確指定
fetch('/api/users', {
    headers: { 'Accept': 'application/json' }
});

RESTful API 設計建議:用 `Accept: application/json` 判斷回應格式,而非依賴 `X-Requested-With`。

copyright © 萬盛學電腦網 all rights reserved