然而，手动集成 reCAPTCHA 并非易事。我们需要处理前端 JavaScript 的加载、渲染，以及后端对 g-recaptcha-response 的验证。更麻烦的是，我们的页面上可能存在多个表单（例如，注册、登录、评论），每个表单都需要独立的 reCAPTCHA 实例，这使得手动集成变得异常复杂和容易出错。我们尝试了几种方法，但都无法优雅地解决多表单验证的问题，代码变得冗余且难以维护。
正当我们为此头疼不已时，我发现了 Composer 包 buzz/laravel-google-captcha，它简直是雪中送炭！这个库为 Laravel 应用量身定制，提供了一套简洁、高效的方式来集成 Google reCAPTCHA，彻底解决了我们的困境。
Composer在线学习地址：学习地址
救星登场：buzz/laravel-google-captcha
buzz/laravel-google-captcha 是一个功能丰富的 Laravel 包，它基于 Google reCAPTCHA SDK，并提供了许多实用的特性，让 reCAPTCHA 的集成变得前所未有的简单：
- 广泛的 Laravel 版本支持：兼容 Laravel 5 到 12，无需担心版本问题。
- 支持页面多验证码：这是它的核心亮点之一，轻松在同一页面上放置多个 reCAPTCHA 实例。
- 重置验证码：提供方法重置已显示的验证码。
- 自动服务发现：Laravel 5.5+ 无需手动注册 ServiceProvider。
- 自定义请求方法：允许灵活配置 reCAPTCHA 的请求方式。
- 动态选项：运行时动态调整 reCAPTCHA 的显示选项。
快速上手：安装与配置
使用 buzz/laravel-google-captcha 非常简单。
-
通过 Composer 安装： 在你的 Laravel 项目根目录运行以下命令：
composer require buzz/laravel-google-captcha
-
服务提供者注册 (Laravel 5.5+ 自动发现)： 如果你使用的是 Laravel 5.5 或更高版本，服务提供者会自动发现，无需手动添加。否则，你需要在
config/app.php的providers数组中添加：'providers' => [ // ... Buzz\LaravelGoogleCaptcha\CaptchaServiceProvider::class, ], -
发布配置文件： 运行以下 Artisan 命令发布配置，你可以自定义 reCAPTCHA 的行为：
php artisan vendor:publish --provider="Buzz\LaravelGoogleCaptcha\CaptchaServiceProvider"
这会在
config目录下生成一个captcha.php文件。 -
配置环境变量： 在你的
.env文件中添加 Google reCAPTCHA 的sitekey和secret。这些密钥你需要到 Google reCAPTCHA 官网（https://www.php.cn/link/944a44559d151ead6928aae68985669c）申请：CAPTCHA_SECRET=你的SecretKey CAPTCHA_SITEKEY=你的SiteKey
在应用中集成 reCAPTCHA
配置完成后，你就可以在视图和控制器中轻松使用 reCAPTCHA 了。
-
在视图中显示 reCAPTCHA： 在你的 Blade 模板中，需要显示 reCAPTCHA 的位置添加以下代码：
<form action="/submit" method="POST"> @csrf <!-- 你的其他表单字段 --> {!! app('captcha')->display() !!} {{-- 或者使用 Facade (需在 config/app.php 中注册别名 'Captcha' => '\Buzz\LaravelGoogleCaptcha\CaptchaFacade') --}} {{-- {!! Captcha::display() !!} --}} <button type="submit">提交</button> </form>你可以通过传递
$attributes数组来自定义 reCAPTCHA 的主题、类型等：{!! app('captcha')->display(['data-theme' => 'dark', 'data-type' => 'audio']) !!}如果你需要支持多语言，也可以传递
$options：{!! app('captcha')->display($attributes = [], $options = ['lang'=> 'zh-CN']) !!} -
在控制器中进行验证：
buzz/laravel-google-captcha提供了一个方便的验证规则。你只需在表单验证规则中添加'g-recaptcha-response' => 'required|captcha'即可：use Illuminate\Http\Request; use Illuminate\Support\Facades\Validator; public function submitForm(Request $request) { $validator = Validator::make($request->all(), [ 'name' => 'required|string', 'email' => 'required|email', 'g-recaptcha-response' => 'required|captcha', // 核心验证规则 ]); if ($validator->fails()) { return redirect()->back()->withErrors($validator)->withInput(); } // 验证通过，处理表单数据 // ... return redirect()->back()->with('success', '表单提交成功！'); } 多验证码支持： 如果你的页面有多个表单，例如一个登录表单和一个注册表单，你可以为每个表单独立调用
display()方法。该库会智能地处理多个 reCAPTCHA 实例的加载和验证，无需额外配置，这正是它最强大的地方！-
测试场景： 在进行单元测试或功能测试时，你可能需要模拟 reCAPTCHA 的验证结果。该库也提供了方便的 Facade Mock 方法：
use Buzz\LaravelGoogleCaptcha\CaptchaFacade; public function testFormSubmissionWithCaptcha() { // 阻止验证码验证失败 CaptchaFacade::shouldReceive('verify')->andReturn(true); // 为 'required' 验证提供隐藏输入 CaptchaFacade::shouldReceive('display') ->andReturn('<input type="hidden" name="g-recaptcha-response" value="1" />'); // ... 执行你的测试请求 }
总结与展望
buzz/laravel-google-captcha 极大地简化了 Google reCAPTCHA 在 Laravel 应用中的集成过程。它的优势显而易见：
- 开发效率提升：告别繁琐的手动集成，一行代码即可显示验证码，一条规则即可完成验证。
- 强大的反垃圾能力：利用 Google reCAPTCHA 的智能识别能力，有效抵御机器人攻击。
- 多表单无忧：轻松应对同一页面上的多个 reCAPTCHA 实例，这是许多其他方案难以比拟的。
- 高可维护性：将 reCAPTCHA 的复杂逻辑封装在库中，使你的应用代码保持整洁。
通过引入 buzz/laravel-google-captcha，我们的社区平台成功地阻止了大部分垃圾注册和评论，用户体验得到了显著提升，运营团队也从繁重的垃圾信息清理工作中解脱出来。如果你也正在为 Laravel 应用的机器人问题而烦恼，强烈推荐你尝试这个强大的 Composer 包，它将成为你构建安全、高效应用的好帮手！
