README

Google reCAPTCHA 验证 PHP 库是软件开发人员用于在 PHP 应用程序内验证 Google reCAPTCHA v2 或 v3 响应的工具。这个库简化了验证用户对 reCAPTCHA 挑战的响应的过程，并为将验证过程集成到 PHP 代码中提供了一个易于使用的接口。

使用这个库，您可以轻松配置和设置 PHP 应用程序的 reCAPTCHA 验证，无需复杂的编码。您可以轻松指定您的 reCAPTCHA API 密钥、密钥和必要的其他配置参数，然后调用库函数来验证从 reCAPTCHA 挑战中收到的响应。

这个库支持 Google reCAPTCHA 的 v2 和 v3 版本，因此您可以使用它来解决广泛的适用场景。它提供了错误处理和报告功能，使您能够轻松检测和处理验证过程中可能出现的任何错误。

Google reCAPTCHA 验证 PHP 库是开源的，可在 GitHub 上免费获取。这个库帮助您轻松地将 Google reCAPTCHA 的强大功能集成到 PHP 应用程序中，确保您的用户免受垃圾邮件和滥用。

安装通过 Composer 处理

$ composer require enunez/grecaptcha-validator

或手动将其添加到您的 composer.json 文件中

{
  "require": {
    "enunez/grecaptcha-validator": "^1.0.0"
  }
}

以下是一个如何使用该库的快速示例

$captcha = Builder::getInstance(YOUR_SHARED_KEY, USER_RESPONSE_TOKEN)->build();

$captcha->isValid();

包括远程 IP 地址

$captcha = Builder::getInstance(YOUR_SHARED_KEY, USER_RESPONSE_TOKEN)->remoteIp(REMOTE_IP)->build();

$captcha->isValid();

如果验证失败，您可以通过以下方式访问所有错误代码

if (!$captcha->isValid()) {
    foreach ($errorCode as $captcha->errorCodes()) {
        // processing the error code
    }
}

许可证

该库是开源软件，根据 MIT 许可证许可。