HTTP基本認證是最簡單的訪問控制機制,通過Authorization頭傳輸Base64編碼的用戶名密碼。無需資料庫、Session或Cookie,適合內部API、測試環境、簡單管理後台。本文解析原理並提供生產級實現代碼。
401 Unauthorized及WWW-Authenticate: Basic realm="..."頭。Authorization: Basic base64(user:pass)。<?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']}!";
hash_equals()防時序攻擊:恆定時間字符串比較。rate limiting防暴力破解。高併發場景建議在Web服務器層處理:
# Nginx
location /admin/ {
auth_basic "Admin Panel";
auth_basic_user_file /etc/nginx/.htpasswd;
# ...
}
PHP層實現適合快速原型、低流量內部工具;生產環境關鍵業務請採用成熟認證框架。