Symfony CAPTCHA Integration
Add a Symfony CAPTCHA to a controller, or more cleanly to a custom Validator constraint, in a few lines of PHP. It stops bot spam on logins, sign-ups and contact forms and keeps CSRF, Twig and the Form component intact. EU-hosted, GDPR-compliant, no image puzzles.
Quickstart
How the integration works
1. Create a CAPTCHA
Create a user account or log in with an existing one. Then create a new CAPTCHA or pick an existing one. If you want to try TrustCaptcha first, every plan comes with a 14-day free trial.
The CAPTCHA overview page shows your site key and license key, and you create your API key there. Add your website’s domains to the authorized domains in the CAPTCHA security rules so they can use your CAPTCHA.


2. Add the CAPTCHA widget to your Twig template
Drop the TrustCaptcha widget into the Twig template that renders your form. The widget runs the CAPTCHA in the background and adds a hidden tc-verification-token field on submit, which arrives on $request->request like any other input.
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>
<form method="post" action="{{ path('contact_submit') }}">
<input type="hidden" name="_token" value="{{ csrf_token('contact') }}">
<input type="email" name="email" required>
<trustcaptcha-component sitekey="<your_site_key>"></trustcaptcha-component>
<button type="submit">Send</button>
</form>The CAPTCHA widget will then be displayed inside your form:

Need detailed information about the CAPTCHA widget integration?
Our documentation has the full widget reference, including themes, languages and custom design.
Read the documentation
3. Validate the token in your Symfony controller
In your Symfony controller, take the verification token from the request, look up the result via our PHP library, and decide whether to accept the request.
First, install our TrustCaptcha PHP library:
composer require trustcomponent/trustcaptcha-php:^3.0Then validate the token inside your controller and act on the result:
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;
use TrustComponent\TrustCaptcha\TrustCaptcha;
class ContactController extends AbstractController
{
#[Route('/contact', name: 'contact_submit', methods: ['POST'])]
public function submit(Request $request): Response
{
$token = $request->request->get('tc-verification-token', '');
try {
$trustCaptcha = new TrustCaptcha('<your_api_key>');
$result = $trustCaptcha->getVerificationResult($token);
} catch (\Throwable $e) {
return $this->render('contact/index.html.twig', ['error' => 'CAPTCHA verification failed.']);
}
if (!$result->verificationPassed || $result->score > 0.5) {
return $this->render('contact/index.html.twig', ['error' => 'CAPTCHA verification failed.']);
}
// CAPTCHA passed — process the request
return $this->redirectToRoute('contact_success');
}
}Need detailed information about the Symfony CAPTCHA integration?
For full step-by-step instructions, including a reusable custom Validator constraint for projects with several protected endpoints, please read our documentation.
Read the documentation
Other backend framework instead of Symfony?
If you use a different framework, pick the matching recipe here. If your framework isn’t listed, your software developers can integrate the verification themselves using our documentation or ask our support team for a pre-built integration.
4. Test your integration
TrustCaptcha is now active. Send a test request and check that it goes through.

FAQs
Where does the Symfony CAPTCHA verification go?
Can I plug the CAPTCHA check into Symfony's Validator?
Does Symfony's Form component bind the widget's hidden token automatically?
Does TrustCaptcha replace Symfony's CSRF protection?
Where should I store the CAPTCHA API key?
TrustCaptcha blocks spam and bots, not customers. No puzzles, GDPR-compliant, EU-hosted.


Protect your Symfony application with TrustCaptcha in just a few steps!
- EU-hosted & GDPR-compliant
- No puzzles
- Try free for 14 days