萬盛學電腦網

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

PHP實現HTTP基本認證:原理、代碼實現與最佳實踐

HTTP基本認證是最簡單的訪問控制機制,通過Authorization頭傳輸Base64編碼的用戶名密碼。無需資料庫、Session或Cookie,適合內部API、測試環境、簡單管理後台。本文解析原理並提供生產級實現代碼。

認證流程

  1. 客戶端請求受保護資源。
  2. 服務器返回401 Unauthorized及WWW-Authenticate: Basic realm="..."頭。
  3. 瀏覽器彈出登錄框,用戶輸入憑證。
  4. 客戶端重發請求,攜帶Authorization: Basic base64(user:pass)。
  5. 服務器驗證,通過返回資源,失敗再次返回401。

PHP完整實現

<?php
function require_basic_auth(string $realm = 'Restricted Area', array $valid_users = []): void {
    // $valid_users = ['user1' => 'pass1', 'user2' => 'pass2'];
    if (!isset($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW'])) {
        send_challenge($realm);
    }
    $user = $_SERVER['PHP_AUTH_USER'];
    $pass = $_SERVER['PHP_AUTH_PW'];
    if (!isset($valid_users[$user]) || !hash_equals($valid_users[$user], $pass)) {
        send_challenge($realm);
    }
    // 認證通過,可將用戶信息存入全局變量供後續使用
    $GLOBALS['AUTH_USER'] = $user;
}

function send_challenge(string $realm): void {
    header('WWW-Authenticate: Basic realm="' . $realm . '"');
    header('HTTP/1.0 401 Unauthorized');
    exit('Access denied. Valid credentials required.');
}

// 使用示例
$users = [
    'admin' => 'secure_password_123',
    'api'   => 'long_random_token_here',
];
require_basic_auth('Admin Panel', $users);
echo "Welcome, {$GLOBALS['AUTH_USER']}!";

關鍵安全點

  • 必须使用HTTPS:Base64非加密,明文等價,HTTPS防竊聽。
  • 使用hash_equals()防時序攻擊:恆定時間字符串比較。
  • 限制嘗試次數:結合rate limiting防暴力破解。
  • 不適用於高安全場景:無登出機制、無會話管理、憑證長期有效。生產環境優先考慮OAuth2/JWT/Session。

Nginx/Apache層面實現(性能更優)

高併發場景建議在Web服務器層處理:

# Nginx
location /admin/ {
    auth_basic "Admin Panel";
    auth_basic_user_file /etc/nginx/.htpasswd;
    # ...
}

PHP層實現適合快速原型、低流量內部工具;生產環境關鍵業務請採用成熟認證框架。

copyright © 萬盛學電腦網 all rights reserved