Google reCAPTCHA V3をPHPのメールフォームへ実装するメモ

<script src="https://www.google.com/recaptcha/api.js?render=発行されたサイトキー></script>

<input type="hidden" name="g-recaptcha-response" id="recaptchaResponse">

<button type="submit" id="submit-btn">確認</button>

<script>
const form = document.getElementById('contact-form');
const submitBtn = document.getElementById('submit-btn');

form.addEventListener('submit', function(e) {
	e.preventDefault(); 
	grecaptcha.ready(function() {
	grecaptcha.execute('発行されたサイトキーを入れる', {action: 'submit'}).then(function(token) {
		document.getElementById('recaptchaResponse').value = token;
		form.submit(); 
	});
	});
});
</script>

define('GR_SITE_KEY', '発行されたサイトキーを入れる');
define('GR_SECRET_KEY', '発行されたシークレットキーを入れる');
define('GR_SCORE', 0.5);

class checkRecaptchaV3{

	public $message;
	public $judge_score;

	function __construct( $secret_key, $recaptcha_response, $score=0.5 ){

		$this->message  = '';

		// POSTリクエストかどうか、トークンが存在するかを確認
		if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($recaptcha_response) && isset($secret_key)) {

			// GoogleのAPIに検証リクエストを送信
			$recaptcha_url = 'https://www.google.com/recaptcha/api/siteverify';
			$recaptcha_data = [
				'secret'   => $secret_key,
				'response' => $recaptcha_response,
				'remoteip' => $_SERVER['REMOTE_ADDR'], // ユーザーのIPアドレスを送信（推奨）
			];

			$options = [
				'http' => [
					'method'  => 'POST',
					'header'  => 'Content-type: application/x-www-form-urlencoded',
					'content' => http_build_query($recaptcha_data),
					'timeout' => 7, // タイムアウトを7秒に設定
				],
			];
			$context  = stream_context_create($options);

			$response_json = @file_get_contents($recaptcha_url, false, $context);


			if ($response_json === false) {
				// APIサーバーとの通信自体に失敗した場合
				$this->message = "reCAPTCHAサーバーとの通信に失敗しました。サイト管理者にお問い合わせください。";

			}else{

				//  APIからのレスポンスをデコード
				$response_data = json_decode($response_json);

				if ($response_data === null) {
					// JSONのデコードに失敗した場合
					$this->message = "reCAPTCHAサーバーから無効な応答がありました。サイト管理者にお問い合わせください。";

				}else{

					// APIが成功応答(success: true)を返さなかった場合のハンドリング
					if (!isset($response_data->success) || $response_data->success !== true) {
						$this->message = "reCAPTCHAの認証に失敗しました。時間をおいて再度お試しください。";
						
						// 失敗理由を追記
						if (isset($response_data->{'error-codes'})) {
							$this->message .= '｜reCAPTCHA verification failed. Error codes: ' . implode(', ', $response_data->{'error-codes'});
						}

					}else{

						//  検証結果を確認
						if ($response_data && $response_data->success) {
							// スコアとアクションを検証
							// スコアの閾値は0.5を基準に、必要に応じて調整
							$this->judge_score = $response_data->score;
							if ($response_data->score >= $score && $response_data->action == 'submit') {
								// ----- 検証成功 -----
			
								$this->message = "";
			
							} else {
								// スコアが低い、またはアクションが一致しない場合
								$this->message = "reCAPTCHAの認証に失敗しました。ボットの可能性があります。";
							}
						} else {
							// APIとの通信に失敗、または無効なトークン
							$this->message = "reCAPTCHAの認証に失敗しました。時間をおいて再度お試しください。";
						}
					}

				}
        
			}
			

		} else {
			// 不正なアクセス
			$this->message = "フォームから正しく送信してください。";
		}
	}

}

require_once('recaptcha.ini.php');

$rcp = new checkRecaptchaV3(GR_SECRET_KEY, $_POST['g-recaptcha-response'], GR_SCORE);

echo '<p>reCaptcha判定スコア:'.$rcp->judge_score.'｜しきい値:'.GR_SCORE.'</p>';

if($rcp->message){
	echo $rcp->message;
	exit;			
}