Laravel Cloudflare Turnstile 使用教程
项目介绍
Laravel Cloudflare Turnstile 是一个帮助开发者轻松集成 Cloudflare Turnstile 到 Laravel 应用中的开源包。Cloudflare Turnstile 是一种替代传统 CAPTCHA 的验证机制,旨在提供更好的用户体验和安全性。
项目快速启动
安装
首先,通过 Composer 安装包:
composer require ryangjchandler/laravel-cloudflare-turnstile
配置
发布配置文件:
php artisan vendor:publish --tag="turnstile-config"
在 config/services.php
文件中添加以下配置:
return [
'turnstile' => [
'key' => env('TURNSTILE_SITE_KEY'),
'secret' => env('TURNSTILE_SECRET_KEY'),
],
];
在 .env
文件中添加你的站点密钥和秘密密钥:
TURNSTILE_SITE_KEY="1x00000000000000000000AA"
TURNSTILE_SECRET_KEY="2x0000000000000000000000000000000AA"
使用
在你的布局文件中包含 Turnstile 脚本:
<html>
<head>
@turnstileScripts()
</head>
<body>
{{ $slot }}
</body>
</html>
应用案例和最佳实践
案例一:表单验证
在表单中使用 Turnstile 进行验证:
<form method="POST" action="/submit">
@csrf
@turnstile()
<button type="submit">Submit</button>
</form>
最佳实践
- 安全性:确保你的秘密密钥不会公开暴露。
- 用户体验:Turnstile 旨在提供无干扰的用户体验,确保在不影响用户操作的情况下进行验证。
典型生态项目
Laravel 生态
Laravel Cloudflare Turnstile 是 Laravel 生态系统中的一部分,与其他 Laravel 包和工具无缝集成,如:
- Laravel Sanctum:用于 API 认证。
- Laravel Horizon:用于队列监控。
- Laravel Telescope:用于调试和监控。
通过这些工具,可以构建一个完整且高效的 Laravel 应用。