reCAPTCHA v2 と v3 の比較 検証エラーの原因、対処

<!-- 1. これだけでチェックボックスが表示される -->
<div class="g-recaptcha" data-sitekey="あなたのサイトキー"></div>

<!-- 2. APIスクリプトの読み込み -->
<script src="https://www.google.com/recaptcha/api.js" async defer></script>

<?php
// 1. フォームからのトークン取得
$recaptchaResponse = $_POST['g-recaptcha-response'];

// 2. Google APIへのリクエスト準備
$url = 'https://www.google.com/recaptcha/api/siteverify';
$data = [
    'secret' => 'あなたのシークレットキー', // 重要：非公開にすること
    'response' => $recaptchaResponse
];

// 3. APIリクエスト実行と結果取得
$response = file_get_contents($url . '?' . http_build_query($data));
$result = json_decode($response);

// 4. 単純な成功/失敗の判定
if ($result->success) {
    // 検証成功の処理
} else {
    // 検証失敗の処理
}
?>

<!-- 
  reCAPTCHA v3のスクリプトを読み込む
  サイトキーを指定して読み込む
  ?render=YOUR_SITE_KEY の形式で指定する
-->
<script src="https://www.google.com/recaptcha/api.js?render=YOUR_SITE_KEY"></script>

<!-- お問い合わせフォームの例 -->
<form id="contactform" action="/submit" method="POST">
  <!-- フォームの内容（名前、メール、メッセージなど） -->
  <input type="text" name="name" placeholder="お名前">
  <input type="email" name="email" placeholder="メールアドレス">
  <textarea name="message" placeholder="メッセージ"></textarea>
  
  <!-- 
    reCAPTCHAトークンを格納するための隠しフィールド
    これがサーバーに送信され、検証に使用される
  -->
  <input type="hidden" name="recaptchaToken" id="recaptchaToken">
  
  <button type="submit">送信する</button>
</form>

<!-- reCAPTCHA処理のためのJavaScript -->
<script>
  // フォーム要素を取得
  const form = document.getElementById('contactform');
  
  // フォーム送信イベントに処理をアタッチ
  form.addEventListener('submit', function(event) {
    // デフォルトの送信をキャンセル
    event.preventDefault();
    
    // reCAPTCHA処理の開始
    // grecaptcha.readyはreCAPTCHAが読み込まれたことを確認
    grecaptcha.ready(function() {
      // サイトキーを使ってreCAPTCHAを実行
      // 第一引数: サイトキー
      // 第二引数: アクション名（ログやダッシュボードで使用）
      grecaptcha.execute('YOUR_SITE_KEY', {
        action: 'submit' // アクション名は自由に設定可能
      }).then(function(token) {
        // 取得したトークンを隠しフィールドに設定
        document.getElementById('recaptchaToken').value = token;
        
        // フォームを実際に送信
        form.submit();
      });
    });
  });
</script>

<?php
// POSTリクエストかどうかを確認
if ($_SERVER['REQUEST_METHOD'] == "POST") {
    
    // reCAPTCHAのシークレットキー（管理画面で取得した秘密鍵）
    $secretKey = 'あなたのシークレットキーをここに設定';
    
    // Google reCAPTCHA検証APIのURL
    $url = 'https://www.google.com/recaptcha/api/siteverify';
    
    // 検証に必要なデータの準備
    $data = [
        'secret' => $secretKey,  // シークレットキー
        'response' => isset($_POST['recaptchaToken']) ? $_POST['recaptchaToken'] : ''  // フォームから取得したトークン
    ];
    
    // cURLセッションの初期化
    $ch = curl_init();
    
    // cURLオプションの設定
    curl_setopt($ch, CURLOPT_URL, $url);  // 接続先URL
    curl_setopt($ch, CURLOPT_POST, true);  // POSTメソッドを使用
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));  // POSTデータ
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);  // 結果を文字列で返す
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);  // SSL証明書の検証を有効化
    
    // cURLリクエストの実行と結果の取得
    $response = curl_exec($ch);
    
    // cURLセッションの終了
    curl_close($ch);
    
    // JSON形式のレスポンスをPHPオブジェクトに変換
    $verifyResult = json_decode($response);
    
    // ここで $verifyResult->success が true なら人間、false ならボットと判定できる
    if ($verifyResult->success) {
        // 検証成功時の処理
        // 例: フォームの本来の処理を続行
    } else {
        // 検証失敗時の処理
        // 例: エラーメッセージを表示
    }
}
?>