reCAPTCHA v2 Enterprise
与 CapMonster Cloud

<?php
require 'vendor/autoload.php';

// 通过 Composer 安装 Google Cloud 库
use Google/Cloud/RecaptchaEnterprise/V1/RecaptchaEnterpriseServiceClient;
use Google/Cloud/RecaptchaEnterprise/V1/Event;
use Google/Cloud/RecaptchaEnterprise/V1/Assessment;
use Google/Cloud/RecaptchaEnterprise/V1/CreateAssessmentRequest;
use Google/Cloud/RecaptchaEnterprise/V1/TokenProperties/InvalidReason;

/**
 * 验证 reCAPTCHA Enterprise 令牌并获取风险评分。
 *
 * @param string $recaptchaKey 你的网站/应用的 reCAPTCHA 密钥
 * @param string $token 从客户端接收到的令牌
 * @param string $projectId Google Cloud 项目 ID
 * @param string $action 与令牌关联的操作名称（action name）
 */
function create_assessment(string $recaptchaKey, string $token, string $projectId, string $action): void {
    $client = new RecaptchaEnterpriseServiceClient();
    $projectName = $client->projectName($projectId);

    // 创建评估事件（assessment event）
    $event = (new Event())->setSiteKey($recaptchaKey)->setToken($token);
    $assessment = (new Assessment())->setEvent($event);
    $request = (new CreateAssessmentRequest())->setParent($projectName)->setAssessment($assessment);

    try {
        $response = $client->createAssessment($request);

        if (!$response->getTokenProperties()->getValid()) {
            echo '令牌无效： ' . InvalidReason::name($response->getTokenProperties()->getInvalidReason());
            return;
        }

        if ($response->getTokenProperties()->getAction() === $action) {
            echo '风险评分： ' . $response->getRiskAnalysis()->getScore();
        } else {
            echo 'reCAPTCHA 标签中的 action 与期望的值不匹配';
        }
    } catch (Exception $e) {
        echo '检查 reCAPTCHA 时出错： ' . $e->getMessage();
    }
}

// 使用这些变量调用该函数
create_assessment(
    'YOUR_SITE_KEY',
    'YOUR_USER_RESPONSE_TOKEN',
    'YOUR_PROJECT_ID',
    'YOUR_RECAPTCHA_ACTION'
);
?>