eighteen73/laravel-turnstile

Composer 安装命令：


                            composer require eighteen73/laravel-turnstile

包简介

Add Cloudflare Turnstile verification to Laravel forms

关键字：

#laravel

README 文档

README

This Laravel Package simplifies the implementation of Cloudflare Turnstile (a CAPTCHA alternative) on your website.

Installation

Require the package via Composer.

composer require eighteen73/laravel-turnstile

Then publish the config file to your project.

php artisan vendor:publish --tag=turnstile-config

Turnstile Credentials

Please refer to the Cloudflare Turnstile documentation for instructions on how to get a Turnstile site key and secret key.

Once you have set up Turnstile in your Cloudflare account you will need to add two new values to your project's .env file.

TURNSTILE_KEY=your-site-key
TURNSTILE_SECRET=your-secret-key

Form Markup

First, you want to ensure that the Turnstile JavaScript is included on your website. Turnstile analyses various telemetry and client behavior exhibited during a session so this script should be included site-wide.

Use the Blade directive @turnstileScripts as follows:

<html>
<head>
    <!-- It could go here if you prefer -->
</head>
<body>

    <!-- The rest of your template -->
    
    @turnstileScripts

</body>
</html>

Then when you wish to protect a form with Turnstile just include the following directive and error response code:

<form action="..." method="post">
    
    <!-- The rest of your form -->
    
    @turnstile
    
    @error('cf-turnstile-response')
        <div class="alert alert-danger">{{ $message }}</div>
    @enderror
    
</form>

Validation Modes

There are two ways to validate your form submissions. The "middleware" mode is enabled by default is completely automatic but you may find it too limited, in which case you should enable the "validation" mode instead.

The validation mode is changed in your project's config/turnstile.php file.

Via Middleware

This will automatically check every request in the web middleware group for a Turnstile response code. If one is found it will verify it before allowing the request to continue.

This validation mode is not ideal if you need to protect middleware groups other than web or you want to more control over how/when the Turnstile errors are reported. For example if you wish to validate Turnstile alongside other form input fields (so all error messages can be displayed together) you should use the "validation" mode below.

Via Form Validation

This gives more flexibility but requires you to manually add the Turnstile response code to your form validation rules wherever it is used.

For example:

use Eighteen73\Turnstile\Rules\Turnstile;

$request->validate([
    'email' => 'required|email',
    'password' => 'required',
    'cf-turnstile-response' => [new Turnstile],
]);

License

The MIT License (MIT). Please see License File for more information.

eighteen73/laravel-turnstile 适用场景与选型建议

eighteen73/laravel-turnstile 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 1.78k 次下载、GitHub Stars 达 2，最近一次更新时间为 2022 年 10 月 08 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「laravel」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 eighteen73/laravel-turnstile 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 eighteen73/laravel-turnstile 我们能提供哪些服务？

定制开发 / 二次开发

基于 eighteen73/laravel-turnstile 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发