TrustComponent
Laravel
TrustCaptcha · Protection anti-bots

Intégration CAPTCHA Laravel

Intégrez un CAPTCHA Laravel dans un contrôleur, ou plus proprement dans une règle de validation Form Request personnalisée, avec quelques lignes de PHP. Il bloque le spam automatisé sur les connexions, inscriptions et formulaires de contact, sans toucher à @csrf ni à votre pipeline de validation. Hébergé dans l'UE, conforme RGPD et sans énigmes visuelles.

Démarrage rapide

Comment fonctionne l'intégration

1. Créer un CAPTCHA

Créez un compte utilisateur ou connectez-vous avec un compte existant. Ensuite, créez un nouveau CAPTCHA ou choisissez-en un existant. Si vous voulez d’abord essayer TrustCaptcha, chaque offre commence par un essai gratuit de 14 jours.

La page d’aperçu du CAPTCHA affiche votre site key et votre license key, et c’est là que vous créez votre API key. Ajoutez les domaines de votre site aux domaines autorisés dans les règles de sécurité du CAPTCHA pour qu’ils puissent utiliser votre CAPTCHA.

Début du formulaire de création du CAPTCHA.
Règles de sécurité CAPTCHA d’un CAPTCHA de démonstration.

2. Ajouter le widget CAPTCHA dans votre template Blade

Placez le widget TrustCaptcha dans le template Blade qui rend votre formulaire. Le widget s’exécute en arrière-plan et ajoute un champ caché tc-verification-token lors de l’envoi, qui arrive sur $request comme tout autre input.

resources/views/contact.blade.php
HTML
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>

<form method="POST" action="{{ route('contact.submit') }}">
    @csrf
    <input type="email" name="email" required>
    <trustcaptcha-component sitekey="<your_site_key>"></trustcaptcha-component>
    <button type="submit">Send</button>
</form>

Le widget CAPTCHA s’affichera ensuite dans votre formulaire :

Début du CAPTCHA

Besoin d’informations détaillées sur l’intégration du widget CAPTCHA ?
Notre documentation contient la référence complète du widget, avec les thèmes, les langues et le design personnalisé.

Lire la documentation

3. Valider le jeton dans votre contrôleur Laravel

Dans votre contrôleur Laravel, récupérez le jeton de vérification depuis $request, consultez le résultat via notre bibliothèque PHP et décidez si la requête doit être acceptée.

Commencez par installer notre bibliothèque PHP TrustCaptcha :

Install
bash
composer require trustcomponent/trustcaptcha-php:^3.0

Validez ensuite le jeton dans votre contrôleur et agissez en fonction du résultat :

ContactController.php
PHP
use Illuminate\Http\Request;
use TrustComponent\TrustCaptcha\TrustCaptcha;

public function submit(Request $request)
{
    $token = $request->input('tc-verification-token');

    try {
        $trustCaptcha = new TrustCaptcha('<your_api_key>');
        $result = $trustCaptcha->getVerificationResult($token);
    } catch (\Throwable $e) {
        return back()->withErrors(['captcha' => 'CAPTCHA verification failed.']);
    }

    if (!$result->verificationPassed || $result->score > 0.5) {
        return back()->withErrors(['captcha' => 'CAPTCHA verification failed.']);
    }

    // CAPTCHA validé — traiter la requête
    return back()->with('status', 'Thanks!');
}

Besoin d’informations détaillées sur l’intégration CAPTCHA Laravel ?
Pour des instructions détaillées étape par étape, y compris une règle Form Request réutilisable pour les projets avec plusieurs endpoints protégés, veuillez consulter notre documentation.

Lire la documentation

Un autre framework backend que Laravel ?
Si vous utilisez un autre framework, choisissez la recette correspondante ici. Si votre framework n’est pas listé, vos développeurs peuvent intégrer la vérification eux-mêmes à l’aide de notre documentation ou contacter notre équipe support pour demander une intégration préconstruite.

Actix Web
ASP.NET Core
Axum
Django
Echo
Express
FastAPI
Fastify
Fiber
Flask
Gin
Hapi
Laravel
Micronaut
NestJS
Next.js
Quarkus
Ruby on Rails
Sinatra
Spring Boot
Symfony

4. Testez votre intégration

TrustCaptcha est maintenant actif. Envoyez une requête de test et vérifiez qu’elle passe.

CAPTCHA terminé

Passer de reCAPTCHA à TrustCaptcha dans Laravel

Si votre application Laravel utilise reCAPTCHA aujourd’hui, le changement concerne les deux mêmes endroits que les étapes ci-dessus : le template Blade et le code qui vérifie le jeton. Dans le template, supprimez le script et le widget reCAPTCHA et ajoutez <trustcaptcha-component> à leur place. Côté serveur, le contrôleur ou la règle de validation lit ensuite tc-verification-token au lieu de g-recaptcha-response et appelle getVerificationResult() de notre bibliothèque PHP à la place de l’endpoint de vérification de Google. Attention au sens du score : avec reCAPTCHA v3, un score reCAPTCHA de 1.0 signifie probablement humain, alors que le score de bot de TrustCaptcha met 0 pour un humain probable ; c’est pourquoi le contrôleur ci-dessus rejette tout ce qui dépasse 0.5. Gardez @csrf tel quel ; la liste complète des étapes figure dans notre guide de migration depuis reCAPTCHA (en anglais).

Questions fréquentes

Où placer la vérification du CAPTCHA Laravel ?
Dans la méthode du contrôleur qui reçoit la soumission du formulaire, avant d'enregistrer un modèle ou d'envoyer un mail. Le jeton CAPTCHA arrive en tant qu'input de requête classique ; lisez-le avec $request->input('tc-verification-token').
Puis-je garder mon package reCAPTCHA pour Laravel et sa règle de validation ?
Non. Les packages reCAPTCHA pour Laravel comme biscolab/laravel-recaptcha envoient le jeton au point de vérification de Google et ne peuvent donc pas vérifier un jeton TrustCaptcha. Supprimez le package avec sa règle et ses entrées de configuration, puis validez tc-verification-token avec notre bibliothèque PHP, par exemple dans la règle Form Request personnalisée décrite dans la question suivante.
Puis-je brancher la vérification CAPTCHA dans la validation Form Request ?
Oui, c'est le pattern le plus propre. Créez une règle personnalisée (php artisan make:rule TrustCaptchaToken) qui appelle notre bibliothèque PHP dans sa méthode validate(), puis ajoutez-la au tableau rules() de votre Form Request. La vérification s'exécute alors dans $request->validated() comme n'importe quelle autre règle.
TrustCaptcha remplace-t-il la protection @csrf de Laravel ?
Non. CSRF et TrustCaptcha sont des couches indépendantes, et les deux doivent rester activées. Conservez @csrf dans votre formulaire Blade et le middleware VerifyCsrfToken dans votre kernel. Le jeton CAPTCHA confirme uniquement qu'un humain a soumis le formulaire.
Où dois-je stocker la clé d'API CAPTCHA ?
Ajoutez TRUSTCAPTCHA_API_KEY dans votre fichier .env et exposez-la via config/services.php sous « trustcaptcha.api_key ». Lisez-la avec config('services.trustcaptcha.api_key') et ne committez jamais la clé brute dans votre dépôt.
Pourquoi le nom du champ contient-il un tiret (tc-verification-token) ?
C'est le nom de champ par défaut posté par le widget. $request->input() et les règles de validation de Laravel acceptent les clés avec tirets sans problème. Si vous préférez le camelCase, définissez token-field-name="trustcaptchaToken" sur le widget et adaptez le contrôleur / la règle en conséquence.
Vous perdez des prospects à cause des CAPTCHAs ?

TrustCaptcha bloque le spam et les bots, pas vos clients. Sans puzzle, conforme au RGPD, hébergé en UE.

Début du CAPTCHA
CAPTCHA terminé
Aucun puzzle pour vos visiteurs
La vérification tourne en arrière-plan pendant la saisie. Davantage de visiteurs vont au bout de vos formulaires au lieu d'abandonner.
Conforme au RGPD
Hébergé dans l'UE, sans cookies, avec transmission chiffrée et suppression automatique des données. Chaque client reçoit un accord de traitement des données (DPA).
Sécurité multicouche
Le proof-of-work adaptatif et le scoring de risque stoppent les abus tôt, même lors d'un pic d'attaques.
Contrôle total
Réglez la sensibilité, gérez des listes d'autorisation et de blocage et utilisez le géoblocage. Vous décidez du niveau d'exigence de la vérification.

Protégez votre application Laravel avec TrustCaptcha en quelques étapes !

  • Hébergé en UE & conforme RGPD
  • Aucun puzzle
  • Essai gratuit de 14 jours