TrustComponent
Laravel
TrustCaptcha · Bot-Schutz

Laravel CAPTCHA-Integration

Binde ein Laravel-CAPTCHA mit wenigen Zeilen PHP in einen Controller ein oder, noch sauberer, in eine eigene Validierungsregel für Form Requests. Es stoppt Bot-Spam bei Logins, Registrierungen und Kontaktformularen, und @csrf sowie deine bestehende Validierung bleiben unangetastet. EU-gehostet, DSGVO-konform und ohne Bilderrätsel.

Schnellstart

So funktioniert die Integration

1. CAPTCHA erstellen

Erstelle ein Benutzerkonto oder melde dich mit einem bestehenden Konto an. Dann erstellst du ein neues CAPTCHA oder wählst ein vorhandenes aus. Wenn du TrustCaptcha erst ausprobieren willst: Jeder Tarif startet mit einer 14-tägigen kostenlosen Testphase.

Auf der Übersichtsseite des CAPTCHAs findest du den Site Key und den License Key, und dort erstellst du auch deinen API-Key. Trage die Domains deiner Website in den Sicherheitsregeln des CAPTCHAs als autorisierte Domains ein, damit sie dein CAPTCHA nutzen dürfen.

Start des Formulars zur Erstellung eines CAPTCHA.
CAPTCHA-Sicherheitsregeln eines Demo-CAPTCHAs.

2. CAPTCHA-Widget in dein Blade-Template einbauen

Binde das TrustCaptcha-Widget in das Blade-Template ein, das dein Formular rendert. Das Widget läuft im Hintergrund und fügt beim Absenden ein verstecktes Feld tc-verification-token hinzu, das auf $request ankommt wie jeder andere 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>

Das CAPTCHA-Widget wird anschließend in deinem Formular angezeigt:

CAPTCHA-Widget vor dem Start

Detaillierte Informationen zur CAPTCHA-Widget-Integration?
Die vollständige Widget-Referenz mit Themes, Sprachen, eigenem Design und mehr findest du in unserer Dokumentation.

Dokumentation lesen

3. Token in deinem Laravel-Controller validieren

Hole in deinem Laravel-Controller den Verifikationstoken aus $request, rufe das Ergebnis über unsere PHP-Library ab und entscheide, ob die Anfrage akzeptiert werden soll.

Installiere zunächst unsere TrustCaptcha-PHP-Library:

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

Validiere dann den Token in deinem Controller und reagiere auf das Ergebnis:

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 bestanden — Anfrage verarbeiten
    return back()->with('status', 'Thanks!');
}

Detaillierte Informationen zur Laravel-CAPTCHA-Integration?
Die vollständige Schritt-für-Schritt-Anleitung, inklusive einer wiederverwendbaren Form-Request-Rule für Projekte mit mehreren geschützten Endpunkten, findest du in unserer Dokumentation.

Dokumentation lesen

Anderes Backend-Framework statt Laravel?
Wenn du ein anderes Framework nutzt, wähle hier das passende Rezept aus. Ist dein Framework nicht aufgeführt, können deine Softwareentwickler die Verifizierung mithilfe unserer Dokumentation selbst integrieren oder unser Support-Team nach einer vorgefertigten Integration fragen.

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. Integration testen

TrustCaptcha ist jetzt aktiv. Schick eine Testanfrage ab und prüfe, ob sie durchgeht.

CAPTCHA abgeschlossen

Umstieg von reCAPTCHA in Laravel

Wer in einer Laravel-App bisher reCAPTCHA nutzt, ändert beim Umstieg dieselben zwei Stellen wie in den Schritten oben: das Blade-Template und den Code, der den Token prüft. Im Template weichen das reCAPTCHA-Skript und das Widget dem Element <trustcaptcha-component>. Controller oder Validierungsregel lesen danach tc-verification-token statt g-recaptcha-response und rufen getVerificationResult() aus unserer PHP-Library auf, wo vorher Googles Prüf-Endpunkt stand. Wichtig ist die Richtung des Scores: Bei reCAPTCHA v3 steht ein reCAPTCHA-Score von 1.0 für einen wahrscheinlichen Menschen, beim Bot-Score von TrustCaptcha die 0, deshalb lehnt der Controller oben alles über 0.5 ab. @csrf bleibt, wie es ist; die vollständige Checkliste steht in unserem Migrationsleitfaden für reCAPTCHA (auf Englisch).

Häufige Fragen

Wo gehört die Laravel-CAPTCHA-Prüfung hin?
In der Controller-Methode, die das abgeschickte Formular empfängt, bevor du ein Modell speicherst oder eine Mail versendest. Der CAPTCHA-Token kommt als regulärer Request-Input; du liest ihn mit $request->input('tc-verification-token').
Kann ich mein reCAPTCHA-Paket für Laravel und seine Validierungsregel behalten?
Nein. reCAPTCHA-Pakete für Laravel wie biscolab/laravel-recaptcha schicken den Token an Googles Prüf-Endpunkt und können deshalb keinen TrustCaptcha-Token prüfen. Entferne das Paket samt Regel und Konfigurationseinträgen und prüfe tc-verification-token stattdessen mit unserer PHP-Library, zum Beispiel in der eigenen Form-Request-Regel aus der nächsten Frage.
Kann ich die CAPTCHA-Prüfung in die Form-Request-Validierung einhängen?
Ja, das ist das sauberste Pattern. Baue eine eigene Rule (php artisan make:rule TrustCaptchaToken), die in ihrer validate()-Methode unsere PHP-Library aufruft, und ergänze sie im rules()-Array deines Form Requests. Die Verifizierung läuft dann als Teil von $request->validated() wie jede andere Rule.
Ersetzt TrustCaptcha den @csrf-Schutz von Laravel?
Nein. CSRF und TrustCaptcha sind unabhängige Schichten, beide sollten aktiviert bleiben. Behalte @csrf in deinem Blade-Formular und die VerifyCsrfToken-Middleware in deinem Kernel. Der CAPTCHA-Token bestätigt nur, dass ein Mensch das Formular abgesendet hat.
Wo speichere ich den CAPTCHA-API-Key?
Trage TRUSTCAPTCHA_API_KEY in deine .env-Datei ein und stelle ihn über config/services.php unter 'trustcaptcha.api_key' bereit. Lies ihn mit config('services.trustcaptcha.api_key') und committe den Key niemals im Klartext ins Repo.
Warum enthält der Feldname einen Bindestrich (tc-verification-token)?
Das ist der Default-Feldname, den das Widget postet. Laravels $request->input() und die Validierungsregeln akzeptieren Input-Keys mit Bindestrich problemlos. Wenn du lieber camelCase nutzt, setze token-field-name="trustcaptchaToken" am Widget und passe Controller / Rule entsprechend an.
Leads verlieren wegen CAPTCHAs?

TrustCaptcha blockiert Spam und Bots, nicht deine Kunden. Keine Rätsel, DSGVO-konform, in der EU gehostet.

CAPTCHA-Start
CAPTCHA abgeschlossen
Keine Rätsel für Besucher
Die Prüfung läuft im Hintergrund, während Besucher tippen. So schicken mehr Menschen deine Formulare ab, statt vorher aufzugeben.
DSGVO-konform
In der EU gehostet, ohne Cookies, mit verschlüsselter Übertragung und automatischer Löschung. Jeder Kunde bekommt einen Auftragsverarbeitungsvertrag (AVV).
Mehrstufige Sicherheit
Adaptiver Proof-of-Work und Risiko-Scoring stoppen Missbrauch früh, auch wenn der Angriffs-Traffic plötzlich steigt.
Volle Kontrolle
Stell die Empfindlichkeit ein, pflege Allow- und Blocklisten und nutze Geoblocking. Du entscheidest, wie streng die Prüfung ist.

Schütze deine Laravel-Anwendung in wenigen Schritten mit TrustCaptcha!

  • EU-hosted & DSGVO-konform
  • Keine Rätsel
  • 14 Tage kostenlos testen