HTTP Basic Authentication 是 HTTP 協定內建的簡易認證機制,透過 Authorization 標頭傳送 Base64 編碼的「帳號:密碼」。雖然安全性不如 OAuth 或 JWT,但因實作簡單、無需資料庫支援,常用於內部管理介面、測試環境、API 簡易保護等場景。
$_SERVER['PHP_AUTH_USER'] 與 $_SERVER['PHP_AUTH_PW'] 是否存在且正確WWW-Authenticate: Basic realm="..." 標頭與 401 Unauthorized 狀態碼<?php
/**
* HTTP Basic 認證守衛函數
* @param string $username 合法帳號
* @param string $password 合法密碼
* @param string $realm 認證領域名稱(顯示於瀏覽器彈窗)
*/
function http_auth($username, $password, $realm = 'Admin Area') {
// 已有認證標頭且帳密正確 -> 直接通過
if (isset($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW'])
&& $_SERVER['PHP_AUTH_USER'] === $username
&& $_SERVER['PHP_AUTH_PW'] === $password) {
return true;
}
// 否則要求認證
header('WWW-Authenticate: Basic realm="' . $realm . '"');
header('HTTP/1.0 401 Unauthorized');
exit('存取被拒絕:請提供有效憑證');
}
// === 使用範例 ===
http_auth('admin', 's3cr3tP@ss', 'My Admin Panel');
// 通過驗證後的受保護內容
echo '<h1>歡迎進入管理後台</h1>';
echo '<p>只有通過驗證的使用者能看到此內容。</p>';
?>
<?php
$validUsers = [
'admin' => 'admin123',
'editor' => 'edit456',
'viewer' => 'view789'
];
if (!isset($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW'])
|| !isset($validUsers[$_SERVER['PHP_AUTH_USER']])
|| $validUsers[$_SERVER['PHP_AUTH_USER']] !== $_SERVER['PHP_AUTH_PW']) {
header('WWW-Authenticate: Basic realm="Multi User Area"');
header('HTTP/1.0 401 Unauthorized');
exit('認證失敗');
}
?>
<?php
session_start();
if (isset($_SESSION['auth_ok'])) {
// 已登入
} elseif (http_auth('admin', 'password')) {
$_SESSION['auth_ok'] = true;
}
?>
<?php
// 強制瀏覽器重新詢問帳密:送出錯誤 realm
header('WWW-Authenticate: Basic realm="Logged Out"');
header('HTTP/1.0 401 Unauthorized');
echo '您已登出,請關閉瀏覽器視窗以完全清除憑證。';
exit;
?>
| 場景 | 建議 |
|---|---|
| 內部測試/開發環境 | ✅ 完美適用 |
| 簡易管理後台(低風險) | ✅ 可接受 |
| 公開 API 生產環境 | ❌ 改用 JWT / OAuth2 |
| 高敏感資料(金融、醫療) | ❌ 禁止使用 |