萬盛學電腦網

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

PHP 實作 HTTP Basic 認證:輕鬆保護頁面存取權限

HTTP Basic Authentication 簡介

HTTP Basic Authentication 是 HTTP 協定內建的簡易認證機制,透過 Authorization 標頭傳送 Base64 編碼的「帳號:密碼」。雖然安全性不如 OAuth 或 JWT,但因實作簡單、無需資料庫支援,常用於內部管理介面、測試環境、API 簡易保護等場景。

核心實作原理

  1. 檢查 $_SERVER['PHP_AUTH_USER'] 與 $_SERVER['PHP_AUTH_PW'] 是否存在且正確
  2. 驗證失敗時,送出 WWW-Authenticate: Basic realm="..." 標頭與 401 Unauthorized 狀態碼
  3. 瀏覽器彈出登入對話框,使用者輸入帳密後重新請求

完整可用程式碼

<?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>';
?>

進階應用技巧

1. 支援多組帳號(陣列比對)

<?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('認證失敗');
}
?>

2. 搭配 Session 避免重複彈窗

<?php
session_start();

if (isset($_SESSION['auth_ok'])) {
    // 已登入
} elseif (http_auth('admin', 'password')) {
    $_SESSION['auth_ok'] = true;
}
?>

3. 登出機制(瀏覽器關閉前無法真正登出,僅能偽裝)

<?php
// 強制瀏覽器重新詢問帳密:送出錯誤 realm
header('WWW-Authenticate: Basic realm="Logged Out"');
header('HTTP/1.0 401 Unauthorized');
echo '您已登出,請關閉瀏覽器視窗以完全清除憑證。';
exit;
?>

安全性注意事項

  • 必須搭配 HTTPS:Base64 非加密,明文傳輸極易被竊聽
  • 不防暴力破解:建議搭配 fail2ban、IP 限流或更換為 Digest/OAuth
  • 無法真正登出:瀏覽器會快取憑證直到關閉分頁/視窗
  • 不適用高敏感系統:生產環境核心功能請採用完整認證授權框架

適用場景速查

HTTP Basic Auth 雖簡陋,但在適當場景下是「開箱即用」的最佳選擇。記住:一定要加 HTTPS,否則帳密等於裸奔。

copyright © 萬盛學電腦網 all rights reserved
場景建議
內部測試/開發環境✅ 完美適用
簡易管理後台(低風險)✅ 可接受
公開 API 生產環境❌ 改用 JWT / OAuth2
高敏感資料(金融、醫療)❌ 禁止使用