Captcha in Symfony: FormType, Validator-Constraint und Controller-Attribut

Installation

Tragen Sie das CaptchaCore-Repository in Ihre composer.json ein und installieren Sie das Bundle:

"repositories": [
    { "type": "composer", "url": "https://captchacore.eu/packages" }
]

composer require captchacore/captchacore-bundle

Danach das Bundle in config/bundles.php eintragen und die Konfiguration anlegen:

// config/bundles.php
CaptchaCore\SymfonyBundle\CaptchaCoreBundle::class => ['all' => true],

# config/packages/captchacore.yaml
captchacore:
    service_url: '%env(CAPTCHACORE_URL)%'
    site_key: '%env(CAPTCHACORE_SITE_KEY)%'
    secret_key: '%env(CAPTCHACORE_SECRET_KEY)%'

Die Schlüssel gehören in die .env:

CAPTCHACORE_URL=https://api.captchacore.eu
CAPTCHACORE_SITE_KEY=cc_pub_…
CAPTCHACORE_SECRET_KEY=cc_sec_…

Der empfohlene Weg: FormType

use CaptchaCore\SymfonyBundle\Form\Type\CaptchaCoreType;

$builder
    ->add('email', EmailType::class)
    ->add('message', TextareaType::class)
    ->add('captcha', CaptchaCoreType::class, [
        'form_type' => 'contact',
    ]);

Das Feld rendert Widget und Token; die Prüfung passiert beim Validieren des Formulars wie bei jedem anderen Feld. Weil das Skript mit dem Feld ausgegeben wird, lädt es nur auf Seiten mit diesem Formular.

Drei weitere Wege

• Controller-Attribut: #[RequiresCaptcha(formType: 'contact')] prüft den Token, bevor die Action läuft — ohne Code in der Methode.
• Validator-Constraint: #[CaptchaCoreToken(formType: 'contact')] an einer Eigenschaft Ihres DTOs, etwa für API-Payloads.
• Twig-Funktion: captchacore_widget() für handgebaute Formulare außerhalb der Form-Komponente.

Programmatisch prüfen Sie mit dem CaptchaCoreClient: $result = $this->captcha->verify($token, 'login') liefert unter anderem Risikowert, Aktion und Begründungen.

Tests ohne Netzwerk

CaptchaCoreClient::fake(VerificationResult::allow());
$this->client->request('POST', '/contact', [...]);
self::assertResponseIsSuccessful();

Das Bundle unterstützt Symfony 6.4 LTS, 7.x und 8.x ab PHP 8.2. Alle Details in der Dokumentation und auf der Seite CAPTCHA-Bundle für Symfony.