salahhusa9 / laravel-geetest-captcha
Laravel GeeTest Captcha for Laravel 9-10-11
Fund package maintenance!
salahhusa9
Requires
- php: ^8.2||^8.0
- illuminate/contracts: ^11.0||^10.0||^9.0
- spatie/laravel-package-tools: ^1.0
Requires (Dev)
- nunomaduro/collision: ^8.0||^7.0||^6.0
- orchestra/testbench: ^9.0||^8.0||^7.0
- phpunit/phpunit: ^11.0||^10.0||^9.0
This package is auto-updated.
Last update: 2024-10-14 11:39:12 UTC
README
Laravel Geetest Captcha is a package that provides a simple way to integrate Geetest Captcha in your Laravel application.
Support us
Does your business depend on our contributions? Reach out and support us on Github sponsor. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff.
Installation
- You can install the package via composer:
composer require salahhusa9/laravel-geetest-captcha
- You need to add
@geetestCaptchaAssets()
in head tag in your layout file:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Document</title> @geetestCaptchaAssets() </head> <body> ... </body> </html>
- Sign up and activate your GeeTest account on the official website
- Create an ID and Key on the dashboard
- add GEETEST_ID and GEETEST_KEY in .env file
Usage
Use in form
You can use in form like this:
In first add @geetestCaptchaInit('captcha-id')
in footer of page as script tag, captcha-id
is the id of the captcha div.
<form method="POST" action="{{ route('login') }}"> @csrf <div class="form-group"> <label for="email">Email</label> <input type="email" name="email" id="email" class="form-control" required> </div> <div class="form-group"> <label for="password">Password</label> <input type="password" name="password" id="password" class="form-control" required> </div> <div class="form-group"> <div id="captcha-id"> <!-- hire we render geetest captcha --> </div> </div> <button type="submit" class="btn btn-primary">Login</button> </form> @geetestCaptchaInit('captcha-id')
and for validation you can use geetest_captcha
rule in your controller like this:
use Salahhusa9\GeetestCaptcha\Rules\GeetestCaptchaValidate; public function login(Request $request) { $request->validate([ 'email' => 'required|email', 'password' => 'required', 'geetest_captcha' => ['required', new GeetestCaptchaValidate] ]); // your logic }
Validate via middleware
You can use in middleware like this:
use Salahhusa9\GeetestCaptcha\Http\Middleware\ValidateGeetestCaptcha; Route::post('login', [LoginController::class, 'login'])->middleware(ValidateGeetestCaptcha::class);
Testing
composer test
Changelog
Please see CHANGELOG 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
License
The MIT License (MIT). Please see License File for more information.