myMVC_module_Captcha

Ce module MYMVC fournit une image CAPTCHA que vous pouvez utiliser dans vos propres formulaires HTML.

Exigences

• Linux
• php> = 7,4
• mymvc
  • mymvc
    • 3.2.x: https://github.com/gueff/mymvc/tree/3.2.x
    • fonctionne avec 3.3.x aussi, mais nécessite PHP> = 8.0 alors
    • Doku: https://mymvc.ueffing.net/
• Ajouter un fichier de police de type véritable
  • Copiez votre copie sous licence d'une police de type véritable comme "Andale Mono" (exemple: anadalemo.ttf ) dans le dossier racine de ce module
  • Renommez ce fichier à font.ttf

---

Installer

CD dans le dossier des modules de votre copie myMVC3.2.x ; Par exemple:

 cd /var/www/myMVC/modules/ ;

clone myMVC_module_Captcha comme Captcha

git clone --branch 1.0.x https://github.com/gueff/myMVC_module_Captcha.git Captcha ; 

Comment utiliser

1. Ajoutez l'itinéraire suivant à votre module de travail principal

 // captcha route
 MVC Route:: GET (
     Captcha  Model Index:: $ sRoute ,
    ' CaptchaControllerIndex::index '
);

2. Ajoutez le contrôle et la création du captcha dans le contrôleur de votre module de travail principal

 // check if captcha is valid
if ( true ===  Captcha  Model Index:: captchaIsValid ())
{
    // captcha is OK!
}

// create captcha for new
$ sCaptchaText =  Captcha  Model Index:: createCaptcha ();

3. Ajoutez ce CAPTCHA FORMULAIRE à votre modèle de frontend

 < form action ="" method =" post " >

  <!-- captcha -->
  < label for =" captcha " > Captcha </ label >
  < img src =" {CaptchaModelIndex::$sRoute} " >
  < input type =" text "
         name =" {CaptchaModelIndex::$sPostFieldName} "
         maxlength =" {CaptchaModelIndex::$iCaptchaTextLength} "
         value =""
         placeholder =" captcha code "
         autofocus
  >
  <!-- /captcha -->

  < button type =" submit " > submit </ button >
</ form >

---

? Remarque: assurez-vous que votre itinéraire autorise la méthode POST

Autorisez la méthode POST dans les itinéraires que vous souhaitez utiliser CAPTCHA.

 MVCRoute::MIX(
    ['GET', 'POST'],
    '/',
    'FooControllerIndex::index',
    $oDTRoutingAdditional->getPropertyJson()
);

Personnalisation

Dans le fichier de configuration de l'environnement de votre module principal, modifiez simplement les propriétés de la classe de modèle CAPTCHA.

Voici un exemple

 //-------------------------------------------------------------------------------------
// Module Captcha

// load Class
require_once $ aConfig [ ' MVC_MODULES_DIR ' ] . ' /Captcha/Model/Index.php ' ;

// declare a custom route
 Captcha  Model Index:: $ sRoute = ' /captcha/MyFormularXY/ ' ;

// add some extra chars to choose from...
 Captcha  Model Index:: $ sChar .= ' _!=)(/&%$[].:,;+*~# ' ;
// ...if you changed the $sChar, do not forget to adjust sanitizing rule
 Captcha  Model Index:: $ sCharSanitizePattern = " /[^ \ p{L}} \ p{M} \ p{S} \ p{N} \ p{P}']+/u " ;

// auto-name template input var (name="") like Route
 Captcha  Model Index:: $ sPostFieldName = str_replace ( ' / ' , '' ,  Captcha  Model Index:: $ sRoute );

// set SessionName like $sPostFieldName
 Captcha  Model Index:: $ sSessionName =  Captcha  Model Index:: $ sPostFieldName ;