This package provides an easy-to-integrate hCaptcha validation rule for Laravel applications, enabling you to protect your forms from bots and spam efficiently. It uses Laravel's built-in HTTP client and validation features to simplify the implementation of hCaptcha.
- Easy integration with any Laravel form.
- Custom validation rule for hCaptcha.
- Configurable through Laravel's standard configuration methods.
You can install the package via Composer by running the following command:
composer require philharmonie/hcaptcha
If you are using a private repository or a local version of the package, ensure you have configured your composer.json
appropriately to recognize the package location.
After installation, publish the configuration file to your application:
php artisan vendor:publish --provider="Philharmonie\LaravelHcaptcha\LaravelHcaptchaServiceProvider" --tag="hcaptcha-config"
This will copy the default configuration file to your application's config directory.
Add the following entries to your .env
file to configure your hCaptcha keys:
HCAPTCHA_SITE_KEY=your_site_key_here
HCAPTCHA_SECRET_KEY=your_secret_key_here
Replace your_site_key_here
and your_secret_key_here
with your actual hCaptcha site and secret keys, respectively.
To use the hCaptcha rule, include it in your form request validation rules like this:
$request->validate([
'h-captcha-response' => new ValidateHCaptcha(),
]);
Add the hcaptcha script to your <header>
and optionally provide a language identifier:
@hcaptchascript(de)
Simply include the hCaptcha widget as follows:
<form method="POST" action="{{ route('your.route') }}">
@csrf
<!-- This will display the hCaptcha -->
@hcaptcha
<button type="submit">Submit</button>
</form>
Contributions are welcome, especially from those who also use this package in their own applications. To contribute:
- Fork the repository.
- Create a new branch for each feature or improvement.
- Send a pull request from each feature branch to the main branch.
If you encounter any problems or have any suggestions, please open an issue on the GitHub repository page.
The Laravel hCaptcha package is open-source software licensed under the MIT license.