TrustComponent
PHP
TrustCaptcha · Protection contre les bots

Intégration CAPTCHA PHP

Protégez vos formulaires, connexions et checkouts contre les bots et le spam avec un CAPTCHA PHP. Notre package PHP vérifie chaque résultat TrustCaptcha sur votre serveur et, à partir de l'offre Solo, vous obtenez aussi un score de bot et des règles de sécurité personnalisées. Hébergé dans l'UE, conforme au RGPD et sans puzzle pour vos visiteurs.

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. Intégrer le widget CAPTCHA dans votre frontend

Intégrez le widget CAPTCHA dans votre site web ou votre application. Le guide du widget CAPTCHA de notre documentation contient les instructions pas à pas.

Lire la documentation

Le widget CAPTCHA s’affichera ensuite sur votre site web ou votre application :

Début du CAPTCHA

Intégrations frontend préconstruites
Nos intégrations frontend préconstruites ajoutent le widget CAPTCHA à votre site web ou à votre application. S’il n’en existe pas encore pour votre technologie frontend, vos développeurs peuvent intégrer le widget eux-mêmes à l’aide de notre documentation ou demander à notre équipe support une intégration préconstruite.

Angular
Contact Form 7
Craft CMS
JavaScript
Joomla
JTL-Shop
Keycloak
Magento 2
React
Shopware 6
Svelte
TYPO3
Vue
Webflow
WordPress

3. Valider le résultat CAPTCHA dans votre backend

Les étapes suivantes montrent comment un backend PHP récupère le résultat de vérification CAPTCHA sur notre serveur et décide de la suite. Les instructions complètes se trouvent dans le guide d’intégration CAPTCHA pour PHP de notre documentation.

Lire la documentation

Installez d’abord notre dépendance TrustCaptcha pour PHP :

Installer
bash
composer require trustcomponent/trustcaptcha-php

Récupérez le résultat de vérification sur notre serveur avec le jeton de vérification et votre API key :

Récupérer le résultat
PHP
// Récupération du résultat de vérification
$verificationResult = null;
try {
  $trustCaptcha = new TrustCaptcha("<your_api_key>");
  $verificationResult = $trustCaptcha->getVerificationResult("<verification_token_from_your_client>");
} catch (Exception $e) {
  // La récupération du résultat de vérification a échoué - gérer l’erreur
}

En fonction du résultat de vérification et de vos besoins, décidez de la suite :

Traiter le résultat
PHP
// Agir en fonction du résultat de vérification
if (!$verificationResult->verificationPassed || $verificationResult->score > 0.5) {
  // La vérification a échoué ou le bot score est > 0.5 – requête automatisée possible
}

Besoin d’informations détaillées sur l’intégration CAPTCHA PHP ?
Notre guide d’intégration CAPTCHA PHP contient les instructions détaillées, et notre dépôt CAPTCHA Samples sur GitHub un exemple d’intégration complet.

Une autre technologie backend que PHP ?
Si votre serveur n’utilise pas PHP, ou si vous avez plusieurs backends, choisissez une autre intégration ici. S’il n’existe pas encore d’intégration préconstruite pour votre technologie backend, vos développeurs peuvent intégrer la vérification eux-mêmes à l’aide de notre documentation ou demander à notre équipe support une intégration préconstruite.

.NET
Go
Groovy
Java
Kotlin
Node.js
PHP
Python
Ruby
Rust
Scala

4. Testez votre intégration

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

CAPTCHA terminé

Questions fréquentes

Que fait l'intégration du CAPTCHA PHP ?
L’intégration PHP valide sur votre serveur un jeton de vérification TrustCaptcha. Votre backend PHP récupère le résultat de vérification depuis TrustCaptcha, puis décide s’il faut accepter, vérifier davantage ou bloquer la requête.
Dois-je toujours intégrer le widget CAPTCHA dans mon frontend ?
Oui. Le jeton de vérification est créé dans votre frontend (site web ou application) lorsque le CAPTCHA est résolu. La partie PHP ne fait que vérifier ce jeton côté serveur.
Comment envoyer le jeton de vérification à mon backend PHP ?
Envoyez-le de la manière qui convient le mieux à votre application, par exemple en tant que champ de formulaire ou dans une requête JSON. Dans les formulaires classiques, un nom par défaut courant est "tc-verification-token", mais vous pouvez choisir votre propre nom de champ.
De quoi ai-je besoin pour valider un jeton en PHP ?
Vous avez besoin du jeton de vérification provenant du frontend et de l’API key de votre CAPTCHA depuis le tableau de bord TrustCaptcha. Avec ces deux éléments, votre serveur peut demander le résultat de vérification à TrustCaptcha.
Comment prendre une décision à partir du résultat de vérification ?
Vérifiez toujours d'abord "verificationPassed". Si vous souhaitez plus de contrôle, utilisez aussi le score de bot (0,0 = très probablement humain, 1,0 = très probablement bot) et commencez avec un seuil comme 0,5, puis ajustez-le selon votre niveau de risque et votre cas d'usage.
Combien de temps un jeton de vérification est-il valide, et peut-il être utilisé plus d’une fois ?
Par défaut, le jeton de vérification est à usage unique et valable 15 minutes. Avec l'offre Enterprise, vous pouvez prolonger sa validité et autoriser un nombre limité de récupérations.
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 PHP avec TrustCaptcha en quelques étapes !

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