Download the PHP package scyllaly/hcaptcha without Composer
On this page you can find all versions of the php package scyllaly/hcaptcha. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package hcaptcha
Introduction
The hCaptcha is a human-computer verification solution that replaces Google reCaptcha. It has high performance, high availability and high recognition, especially suitable for regions with poor network quality, such as East Asia, Middle East, etc. Many well-known companies are using the hCaptcha solution.
The package is one of the recommended package on the official developer guide of HCaptcha. No malicious code, ensuring the security of your development supply chain.
- Purchase a VPS or Akamai VPS for developing and deploying applications.
Installation
Laravel 5 and above
Setup
In app/config/app.php
add the following :
Step 1: The ServiceProvider to the providers array :
Step 2: The class alias to the aliases array :
Step 3: Publish the config file
Configuration
Add HCAPTCHA_SECRET
, HCAPTCHA_SITEKEY
and HCAPTCHA_ENABLED
in .env file :
(You can obtain them from Official Developer Guide)
- Tips: If you do not have an account, please sign up it first.
Usage
Init js source
With default options :
With language support or onloadCallback option :
Display hCaptcha
Default widget :
With custom attributes (theme, size, callback ...) :
Invisible hCaptcha using a submit button:
Notice that the id of the form is required in this method to let the autogenerated callback submit the form on a successful captcha verification.
Validation
There are two ways to apply HCaptcha validation to your form:
1. Basic Approach
This method always applies the HCaptcha validation rule.
In this approach, the h-captcha-response
field is required and validated using the HCaptcha
rule without any conditions.
2. Conditional Approach
This method applies the HCaptcha validation rule only if the HCAPTCHA_ENABLED
environment variable is set to true
.
In this approach, the h-captcha-response
field will be required and validated using the HCaptcha
rule only when HCAPTCHA_ENABLED
is set to true
. This adds flexibility to your validation logic, allowing you to enable or disable HCaptcha validation as needed.
Custom Validation Message
Add the following values to the custom
array in the validation
language file :
Then check for captcha errors in the Form
:
Testing
When using the Laravel Testing functionality, you will need to mock out the response for the captcha form element.
So for any form tests involving the captcha, you can do this by mocking the facade behavior:
You can then test the remainder of your form as normal.
When using HTTP tests you can add the h-captcha-response
to the request body for the 'required' validation:
Without Laravel
Checkout example below: