萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

網站整合 Google reCAPTCHA v2:從註冊到驗證完整實作

前置準備

  1. 前往 Google reCAPTCHA 管理主控台
  2. 註冊網站:選擇 **reCAPTCHA v2 ("I'm not a robot" Checkbox)**
  3. 填入網域 (含 localhost 測試)
  4. 取得 **Site Key (公鑰)** 與 **Secret Key (私鑰)**

前端整合 (表單頁面)

<form action="verify.php" method="POST">
  <!-- 其他欄位 -->
  
  <div class="g-recaptcha" data-sitekey="你的_Site_Key"></div>
  <script src="https://www.google.com/recaptcha/api.js" async defer></script>
  
  <button type="submit">送出</button>
</form>

後端驗證 (PHP 範例)

<?php
// verify.php
require_once 'recaptchalib.php';  // 官方 PHP Library

$secret = "你的_Secret_Key";
$response = $_POST['g-recaptcha-response'];
$remoteip = $_SERVER['REMOTE_ADDR'];

$resp = recaptcha_check_answer($secret, $remoteip, $response);

if (!$resp->is_valid) {
    die("驗證失敗:" . $resp->error . " <a href='javascript:history.back()'>返回</a>");
}

// 驗證通過,繼續業務邏輯
echo "驗證成功!";
// 處理表單資料...
?>

必要檔案

下載官方 PHP Library:recaptchalib.php
來源:google/recaptcha (GitHub)
放置於專案可引用路徑 (如 lib/ 或 skin/google/)。

進階:AJAX 表單驗證

// 前端 JS
grecaptcha.ready(function() {
    grecaptcha.execute('Site_Key', {action: 'submit'}).then(function(token) {
        $.post('verify_ajax.php', { 'g-recaptcha-response': token, ...formData }, function(res) {
            if (res.success) { /* 成功 */ } else { /* 顯示錯誤 */ }
        }, 'json');
    });
});

// 後端 verify_ajax.php
$resp = recaptcha_check_answer($secret, $_SERVER['REMOTE_ADDR'], $_POST['g-recaptcha-response']);
echo json_encode(['success' => $resp->is_valid, 'error' => $resp->error ?? '']));

常見問題

問題解決
顯示 "ERROR for site owner: Invalid domain for site key"管理主控台網域設定需包含目前網域 (含 port)
無法載入 api.js大陸環境需使用 recaptcha.net 域名:https://recaptcha.net/recaptcha/api.js
驗證通過但機器人仍可繞過啟用「分數模式」v3 或增加蜜罐欄位、裝置指紋等二次防護
Secret Key 洩露立即在主控台重新產生、輪換金鑰

版本選擇建議

  • v2 Checkbox:最通用、使用者熟悉、支援度最高
  • v2 Invisible:無勾選框,按鈕觸發,體驗較好但需處理回調
  • v3:無互動、回傳分數 (0.0-1.0),需自行設定閾值,適合高風險表單
copyright © 萬盛學電腦網 all rights reserved