主流 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 / 原生 XHR | IE5/6 不自動發送;原生 new XMLHttpRequest() 需手動 setRequestHeader | 相容性缺口 |
<?php
// 前端
fetch('/api/data?ajax=1') // 或 POST body 帶 ajax=1
// 後端
function isAjax(): bool {
return isset($_REQUEST['ajax']); // 或 $_GET/$_POST
}
?>
<?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/users → 只回 JSON,強制 Accept: application/json/users → 回 HTML 頁面<?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);
?>
$request->ajax() (檢查 Header)、$request->wantsJson() (檢查 Accept)、$request->expectsJson() (兩者或)$request->isXmlHttpRequest()、$request->getPreferredFormat()/api/ 自動設置響應格式