Download the PHP package njoguamos/laravel-turnstile without Composer
On this page you can find all versions of the php package njoguamos/laravel-turnstile. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download njoguamos/laravel-turnstile
More information about njoguamos/laravel-turnstile
Files in njoguamos/laravel-turnstile
Package laravel-turnstile
Short Description A laravel wrapper for https://developers.cloudflare.com/turnstile/
License MIT
Homepage https://github.com/njoguamos/laravel-turnstile
Informations about the package laravel-turnstile
Cloudflare Turnstile for Laravel 10+
Turnstile is a new user friendly, privacy preserving alternative to CAPTCHA. This package provides a flexible way of integrating turnstile into your Laravel application. This package can be turned on and off for your convenience.
Info This package focuses on server side validation. You are free to implement your preferable client side technology such vue, reach, blade e.t.c
Version compatibility
Version | PHP versions | Laravel versions |
---|---|---|
1.x.x | 8.0, 8.1 and 8.2 | 9.x and 10.x |
2.x.x | 8.1, 8.2 and 8.3 | 10.x and 11.x |
Installation
You can install the package via composer:
You can initialise the package with:
The install command will publish the config file.
Ensure that you have update your application .env
with credentials from cloudflare i.e.
Usage
There are three way to use this package.
1. As a middleware
To use turnstile is specific routes of your application, you can register a new middleware in your laravel app/Http/Kernel.php
.
``
Once the middleware has been defined in the HTTP kernel, you may use the middleware method to assign middleware to a route:
Ensure your client side technology submit a turnstile token using a name defined in turnstile config file. Your can learn how to implement client side render from cloudflare website. Example:
Upon submitting the form, the turnstile token will be validated against turnstile api. If it fails, the request will be redirected back with status
message. You can handle this message however you want in client side.
2. As a validation rule (v2.x.x)
You can user the inbuilt validation to validate form input
3. Manual
You can validate turnstile token by calling validate method of Turnstile
facade. The result will be true
when token passed and false
when token fails.
Disabling
To increase the speed of your unit tests, you may wish to disable the turnstile. You can do so by setting TURNSTILE_ENABLED
to false. i.e
When disabled,
- turnstile middleware will always pass
- turnstile validation rule will always pass
😀 Remember to turn turnstile on when you deploy.
Testing
Info This package does not mock request. It uses the secret keys provided by Cloudflare. Therefore, test scenarios hits the real turnstile api.
Changelog
Please see releases for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Njogu Amos
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-turnstile with dependencies
guzzlehttp/guzzle Version ^7.5
illuminate/contracts Version ^10.0
spatie/laravel-package-tools Version ^1.13.0