萬盛學電腦網

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

微信掃碼登入網站完整實作:基於 Snoopy 的 Wechatauth SDK

架構概覽

本 SDK 實現「網頁顯示 QR Code → 使用者掃碼 → 手機確認 → 後端輪詢驗證 → 取得 Cookie/用戶資訊」完整流程,核心依賴 Snoopy 模擬瀏覽器 HTTP 行為 (Cookie 管理、重導向、User-Agent)。

核心類別結構 (Wechatauth)

class Wechatauth {
    private $cookie;           // 登入 Cookie
    private $_cookiename;      // Cookie 快取檔案路徑
    private $_cookieexpired = 3600; // 快取有效秒數
    private $_account;         // 帳號識別
    private $_datapath;        // 資料儲存目錄
    public $login_user;        // 登入成功後的用戶資訊

    // 建構子:初始化參數、嘗試載入舊 Cookie
    public function __construct($options) { ... }

    // Cookie 持久化:存/讀/刪
    public function saveCookie($filename, $content) { ... }
    public function getCookie($filename) { ... }
    public function deleteCookie($filename) { ... }

    // 核心流程三步驟
    public function get_login_code() { ... }      // 1. 取得 UUID (授權碼)
    public function get_code_image($code = '') { ... } // 2. 組 QR Code 圖片 URL
    public function verify_code() { ... }         // 3. 輪詢驗證掃碼狀態 (200=成功)

    // 登入後功能
    public function get_login_cookie() { ... }    // 取得可攜帶的登入 Cookie
    public function sendNews($account, $title, $summary, $content, $pic, $srcurl='') { ... }
    public function get_avatar($url) { ... }
}

關鍵流程細節

步驟 1:取得登入授權碼 (UUID)

public function get_login_code() {
    $t = time() . strval(mt_rand(100, 999));
    $codeurl = "https://login.weixin.qq.com/jslogin?appid=wx782c26e4c19acffb"
             . "&redirect_uri=https%3A%2F%2Fwx.qq.com%2Fcgi-bin%2Fmmwebwx-bin%2Fwebwxnewloginpage"
             . "&fun=new&lang=zh_CN&_=$t";

    $snoopy = new Snoopy;
    $snoopy->fetch($codeurl);
    $result = $snoopy->results;

    // 解析回傳 JS: window.QRLogin.uuid = "xxx";
    preg_match('/window\.QRLogin\.uuid\s*=\s*"([^"]+)"/', $result, $matches);
    if (count($matches) > 1) {
        $this->_logincode = $matches[1];
        $_SESSION['login_step'] = 0;
        return $this->_logincode;
    }
    return $result;
}

步驟 2:產生 QR Code 圖片網址

public function get_code_image($code = '') {
    if (!$code) $code = $this->_logincode;
    if (!$code) return false;
    return "https://login.weixin.qq.com/qrcode/$code?t=webwx";
}

前端直接 `` 即可顯示。

步驟 3:輪詢驗證掃碼結果

需定時 (如每 1-2 秒) AJAX 呼叫 `verify_code()`,回傳狀態碼:

  • 200:確認登入成功,可呼叫 `get_login_cookie()` 取得 Cookie
  • 201:已掃碼,待手機確認
  • 408:逾期/取消
  • 其他:錯誤

前端整合範例 (jQuery 輪詢)

<div id="qrcode"><img src="get_qrcode.php" alt="掃碼登入"></div>
<script>
function poll() {
    $.get("verify.php", function(res) {
        if (res.code === 200) {
            location.href = "dashboard.php"; // 登入成功跳轉
        } else if (res.code === 201) {
            setTimeout(poll, 1500); // 待確認,繼續輪詢
        } else {
            $("#qrcode img").attr("src", "get_qrcode.php?" + Date.now()); // 重新整理 QR
            setTimeout(poll, 3000);
        }
    }, "json");
}
$(poll);
</script>

安全與維運注意事項

  • Snoopy 老舊:建議改用 guzzlehttp/guzzle 或 symfony/http-client,支援 HTTP/2、非同步、中介軟體。
  • Cookie 安全儲存:`$_datapath` 應置於網站根目錄外,檔案權限 `0600`,避免洩漏。
  • AppID/Secret 管理:範例寫死 `wx782c26e4c19acffb`,實務應從環境變數/設定檔讀取。
  • 微信風控:高頻請求、異常 IP 易觸發封鎖,需實作指數退避、IP 池、驗證碼備援。
  • 官方替代方案:微信開放平台「網站應用微信登入」 (OAuth2.0 標準流程) 更穩定、合規,建議優先評估。

總結

此 SDK 示範「模擬瀏覽器掃碼登入」的完整邏輯,適合學習 HTTP 協議、Cookie 管理、輪詢機制。生產環境請優先採用官方 OAuth2.0 或維護良好的 Composer 套件 (如 `overtrue/wechat`)。

copyright © 萬盛學電腦網 all rights reserved