PHP實現Google Authenticator雙因素驗證的完整教程

gitbox 2025-06-27

Google Authenticator 是一款由Google 推出的雙因素認證工具，它通過生成一次性驗證碼（OTP）為賬戶提供額外的安全層。用戶在登錄時不僅需要輸入用戶名和密碼，還需輸入由移動設備生成的動態驗證碼，有效降低了賬戶被盜的風險。

這種基於時間的一次性密碼（TOTP）機制，會在固定時間間隔內自動刷新驗證碼，使得攻擊者即使竊取到驗證碼也難以重複使用。

為了在PHP 中實現基於Google Authenticator 的驗證功能，需要依賴相應的第三方庫。以下是具體的實現步驟：

首先通過Composer 安裝Google Authenticator 相關依賴。在項目的composer.json文件中添加以下內容，並執行安裝命令：

 
"require": {
    "google/authenticator": "^1.0"
}

安裝完成後，即可在代碼中引入該庫使用。

為每位用戶生成唯一的密鑰，是實現雙因素認證的關鍵。可以使用庫中的方法如下：

 
use Google\Authenticator\GoogleAuthenticator;

$ga = new GoogleAuthenticator();
$secret = $ga->generateSecret();

上述代碼通過generateSecret()方法創建一個安全密鑰，後續將用於生成和校驗一次性驗證碼。

為了便於用戶將密鑰與手機綁定，可生成一個二維碼鏈接，用戶可通過Google Authenticator 掃描綁定：

 
$qrCodeUrl = $ga->getQRCodeUrl('My Website', $secret);

生成的URL 可用於二維碼生成工具，將其展示在網頁上供用戶掃碼綁定。第一個參數為應用名稱，第二個參數為用戶密鑰。

在用戶登錄或進行敏感操作時，需要驗證其輸入的驗證碼是否有效：

 
$isValid = $ga->checkCode($secret, $userInputCode);
if ($isValid) {
    // 驗證成功，允許訪問
} else {
    // 驗證失敗，拒絕訪問
}

只需將用戶密鑰與輸入的驗證碼傳入checkCode()方法即可完成校驗。驗證通過則返回true，否則返回false。

集成Google Authenticator 為PHP 應用提供了有效的雙因素身份驗證機制。通過為用戶生成唯一密鑰、展示二維碼綁定及校驗動態驗證碼，可以大大增強賬戶的安全性。該方法實現簡單、可靠，適用於需要提升登錄安全的各種PHP 項目。