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.


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.
<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:

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:
composer require trustcomponent/trustcaptcha-php:^3.0Validiere dann den Token in deinem Controller und reagiere auf das Ergebnis:
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.
4. Integration testen
TrustCaptcha ist jetzt aktiv. Schick eine Testanfrage ab und prüfe, ob sie durchgeht.

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?
Kann ich mein reCAPTCHA-Paket für Laravel und seine Validierungsregel behalten?
Kann ich die CAPTCHA-Prüfung in die Form-Request-Validierung einhängen?
Ersetzt TrustCaptcha den @csrf-Schutz von Laravel?
Wo speichere ich den CAPTCHA-API-Key?
Warum enthält der Feldname einen Bindestrich (tc-verification-token)?
TrustCaptcha blockiert Spam und Bots, nicht deine Kunden. Keine Rätsel, DSGVO-konform, in der EU gehostet.


Schütze deine Laravel-Anwendung in wenigen Schritten mit TrustCaptcha!
- EU-hosted & DSGVO-konform
- Keine Rätsel
- 14 Tage kostenlos testen