拓展阅读：Laravel验证码插件Captcha快速指南

拓展阅读：Laravel验证码插件Captcha快速指南

captcha Captcha for Laravel 5/6/7/8/9/10 项目地址: https://gitcode.com/gh_mirrors/ca/captcha

---

项目介绍

Captcha for Laravel 是一个专为 Laravel 框架设计的简单验证码服务提供商。它支持 Laravel 5 到最新的 Laravel 11 版本，提供了一种易于集成的方式来增强网站的安全性，通过添加数学验证或传统的文本验证码来防止自动机器人和垃圾邮件提交。此插件利用了 Intervention Image 库来生成验证码图片，具有高度的定制性和灵活性。

项目快速启动

安装

首先，你需要在你的 Laravel 项目中通过 Composer 添加 mews/captcha 包：

composer require mews/captcha

接下来，如果你使用的是 Laravel 5.1 或以上版本，确保在 composer.json 中设置正确的稳定性，并运行更新命令：

{
    "minimum-stability": "dev",
    "prefer-stable": true
}

然后执行 composer update。

对于配置，Laravel 5.1 及更高版本需要在 config/app.php 文件的 providers 和 aliases 部分手动注册服务提供者和门面：

// config/app.php
'providers' => [
    // ...
    Mews\Captcha\CaptchaServiceProvider::class,
],

'aliases' => [
    // ...
    'Captcha' => Mews\Captcha\Facades\Captcha::class,
],

如果使用的是 Laravel 11，则自动加载别名。

使用示例

在路由文件（如 routes/web.php）中，你可以创建一个用于展示和验证验证码的简单端点：

Route::get('/captcha-test', function () {
    return view('captcha-test');
});

Route::post('/captcha-test', function () {
    $rules = ['captcha' => 'required|captcha'];
    $validator = Validator::make(Request::all(), $rules);
    if ($validator->fails()) {
        return back()->withErrors(['captcha' => '验证码不正确']);
    }
    return "验证码验证成功!";
});

并在视图文件 captcha-test.blade.php 中显示验证码：

{!! Captcha::display(); !!}
<form method="post">
    {{csrf_field()}}
    <label for="captcha">请输入验证码:</label>
    <input type="text" id="captcha" name="captcha">
    <button type="submit">提交</button>
</form>

应用案例与最佳实践

• 自定义配置：通过发布配置文件，可以调整验证码长度、尺寸、质量等参数，以适应不同的视觉需求。命令是 php artisan vendor:publish --provider="Mews\Captcha\CaptchaServiceProvider" --tag=config。
• 无状态模式：适用于API场景，通过请求验证码的URL和验证时传入密钥进行操作，增加安全性。
• 环境变量禁用：在生产环境中，可以通过设置环境变量 CAPTCHA_DISABLE=true 来全局禁用验证码验证，便于测试阶段的便捷操作。

典型生态项目

虽然该教程专注于Captcha插件本身，但它的应用广泛，特别是在需要用户验证的表单中。结合Laravel的身份验证系统，可以在注册、登录保护、评论提交等多个场景下提升数据安全。此外，也可以与其他生态项目如表单构建器Form Request、以及前端框架Vue.js或React结合使用，实现前后端分离下的验证码动态验证，增强用户体验和站点安全。

---

此快速指南旨在帮助开发者快速上手并有效利用 Captcha for Laravel，通过简单的步骤即可加强应用程序的安全防护。记住，良好的用户体验同样重要，因此在实施验证码策略时，保持易用性也是一个考虑的重点。

captcha Captcha for Laravel 5/6/7/8/9/10 项目地址: https://gitcode.com/gh_mirrors/ca/captcha