萬盛學電腦網

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

PHP 登錄認證類設計:Session/Cookie 管理、數據庫驗證、錯誤處理

類結構設計

<?php
class Login {
    // 配置屬性
    private string $authTable = 'account';
    private bool $useCookie = true;
    private string $cookiePath = '/';
    private int $cookieTime = 108000; // 30小時

    // 錯誤信息模板
    private string $errMysql = '數據庫連接失敗';
    private string $errUsername = '用戶名無效';
    private string $errUser = '用戶被禁用';
    private string $errPassword = '密碼錯誤';
    public string $err = '';

    // 運行時狀態
    public string $username = '';
    public int $userid = 0;
    public int $userlevel = 0;
    private bool $errorReport = false;

    // 構造函數:建立數據庫連接
    public function __construct(string $host, int $port, string $user, string $pass, string $db) {
        if (!@mysqli_connect($host . ':' . $port, $user, $pass, $db)) {
            $this->reportError($this->errMysql);
            throw new Exception($this->errMysql);
        }
        // 建議改用 PDO + 依賴注入
    }

    // 檢查是否已登錄 (Session + Cookie 雙重檢查)
    public function isLoggedIn(): bool {
        if (isset($_COOKIE['sid'])) {
            session_id($_COOKIE['sid']);
            session_start();
            return $this->restoreSession();
        }
        session_start();
        return $this->restoreSession();
    }

    private function restoreSession(): bool {
        if (isset($_SESSION['username'])) {
            $this->username = $_SESSION['username'];
            $this->userid = $_SESSION['userid'];
            $this->userlevel = $_SESSION['userlevel'];
            return true;
        }
        return false;
    }

    // 用戶認證核心邏輯
    public function userAuth(string $username, string $password): bool {
        // 1. 參數驗證
        // 2. 預處理查詢
        // 3. password_verify()
        // 4. 寫入 Session
        // 5. 可選:設定 Cookie 記住我
        // 此處略,實際項目請完善
        return false;
    }

    // 登出
    public function logout(): void {
        $_SESSION = [];
        if (ini_get('session.use_cookies')) {
            $params = session_get_cookie_params();
            setcookie(session_name(), '', time() - 42000, $params['path'], $params['domain'], $params['secure'], $params['httponly']);
        }
        session_destroy();
    }

    private function reportError(string $msg): void {
        $this->err = $msg;
        if ($this->errorReport) trigger_error($msg, E_USER_WARNING);
    }
}
?>

關鍵改進點 (對比原始代碼)

  • 使用 mysqli/PDO 替代已移除的 mysql_* 函數。
  • 密碼驗證使用 password_verify(),存儲用 password_hash()。
  • 屬性封裝 private,暴露必要 public 接口。
  • 異常處理替代 die(),便於上層捕獲。
  • 登出徹底銷毀 Session 與 Cookie。
  • 支援依賴注入 (構造函數傳入 PDO 實例) 更利於測試。

使用示例

<?php
require 'Login.php';
$login = new Login('localhost', 3306, 'dbuser', 'dbpass', 'mydb');

if ($login->isLoggedIn()) {
    echo "歡迎回來, {$login->username}!";
} elseif ($_SERVER['REQUEST_METHOD'] === 'POST') {
    if ($login->userAuth($_POST['username'], $_POST['password'])) {
        header('Location: dashboard.php');
        exit;
    } else {
        echo "錯誤: {$login->err}";
    }
}
?>
<form method="post">
用戶名: <input name="username"><br>
密碼: <input name="password" type="password"><br>
<button>登錄</button>
</form>
copyright © 萬盛學電腦網 all rights reserved