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 核心原始碼片段
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
此為非標準慣例標頭,非 W3C 強制規範,但已成行業事實標準。
var xhr = new XMLHttpRequest();
xhr.open('GET', '/api/data');
xhr.setRequestHeader('X-Request-Type', 'ajax'); // 自定義標頭
xhr.send();
$.ajax({
url: '/api/data',
beforeSend: function(xhr) {
xhr.setRequestHeader('X-Request-Type', 'ajax');
},
success: function(data) {
$('#result').html(data);
}
});
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
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
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` |
| 代理/負載均衡 | 可能移除/修改標頭 | 檢查代理設定,確保透傳 |
<?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`。