Mettez en œuvre les captchas avec Zend Framework

Cet objet, bien qu'anecdotique, permet de créer des captchas où le mot à repérer se trouve écrit en ASCII art. Voilà des exemples de rendus que l'on pourra obtenir :

Le développeur ne pourra pas paramétrer grand-chose : à part le nombre de lettres du captcha, rien de spectaculaire.

// instanciation et paramétrage
$captcha = new Zend_Captcha_Figlet();
$captcha ->setWordLen(7);

Voilà vraiment la classe qui permettra de générer des images déformées pour masquer du texte. Cet objet intègre du texte dans une image et y ajoute du bruit : des étoiles et des lignes. Le développeur a la possibilité de spécifier la taille (hauteur, largeur) de l'image générée, la police de caractères à utiliser, la taille du texte, le niveau de bruit des étoiles et le niveau de bruit des lignes. Zend_Captcha_Image utilise la bibliothèque GD pour générer les images, vous devez donc l'avoir installée sur le serveur web. Étant donné que les captchas seront générés puis stockés directement sur le serveur, cette solution de captchas est parfaitement utilisable dans le cas où le client ne serait présent que sur un intranet sans accès extérieur. En ce sens c'est la solution la mieux maitrisée puisque le serveur a toutes les clefs : la génération du captcha et sa validation.

Voici quelques exemples de captchas faisant varier le niveau de bruit des étoiles et des lignes :

Attention cependant au choix de la police. Bien que le but d'un captcha étant de masquer un texte et de le rendre peu (auto)lisible, il ne faut pas tomber dans l'excès d'un camouflage trop important. Il suffit de générer un captcha avec une police cursive (Mistral par exemple) pour obtenir des captchas vraiment peu lisibles même par un être humain. Bon courage :

Les autres paramètres du Zend_Captcha_Image concernent l'emplacement de stockage des captchas générés et n'offrent que peu d'intérêt pédagogique. Voici le code illustrant l'utilisation de Zend_Captcha_Image, toujours selon notre template défini plus haut.

<?php 
 
require_once 'Zend/Loader/Autoloader.php';
Zend_Loader_Autoloader::getInstance()->registerNamespace('Zend_');
 
// instanciation, paramétrage
$captcha = new Zend_Captcha_Image();
$captcha ->setWordLen(8)
        ->setHeight(100)
        ->setWidth(300)
        ->setFont("./tahoma.ttf")       
        ->setFontSize(50)           
        ->setSuffix(".png")  
        ->setImgDir("out/")
        ->setImgUrl("out")
        ;
 
if (!isset($_POST['captcha'])){
    $captcha->generate();
}else{
 
    // vérification
 
    if ($captcha->isValid($_POST['captcha'])){
        echo '<img src="ok.gif" />';
        $captcha->generate();
    }else{
        $captcha->generate();
        echo '<img src="ko.png"/>';
    }
}
?>
<form method="post">
 
<img src="<?php echo $captcha->getImgUrl () . $captcha->getId() ?>.png"/><br/>
 
<input type="hidden" name="captcha[id]" value="<?php echo $captcha->getId() ?>" size="40" /><br/>
<input type="text" name="captcha[input]" size="40" /><br/>    
<input type="submit"/>
</form>

Toutes les images générées seront ici stockées dans le dossier out/. Zend_Captcha_Image intègre une logique de garbage collector et passe automatiquement régulièrement pour vider le contenu de ce dossier. La fonction setGcFreq permet de spécifier à quelle fréquence de requêtes le garbage collector doit être appelé.

On notera que la vérification du captcha nécessite l'id du captcha généré ainsi que le mot repéré qui doivent être passés dans un même paramètre HTTP.

Ce système de captcha utilise le service web reCAPTCHA (racheté par Google) pour générer et vérifier le texte à reconnaître. Les images proposées à la reconnaissance de mots proviennent d'éléments non reconnus dans une analyse automatique de caractères. En résolvant des captchas reCAPTCHA, vous participez à la numérisation d'ouvrages qui n'ont pu être entièrement numérisés. Vous avez toujours deux mots à reconnaître : l'un d'eux est connu (c'est sur celui-ci que se fera la validation) et l'autre est à déchiffrer : c'est la participation à la numérisation.

Pour pouvoir utiliser le service reCAPTCHA, vous devez créer des clefs d'authentification publique et privée. Pour cela rendez-vous sur le site https://www.google.com/recaptcha/admin/create puis générer une paire de clefs pour le domaine web de votre application. Il n'est pas rare de devoir générer une paire de clefs en mode développement si vous travaillez sur un domaine *.localhost et une autre paire de clefs pour la mise en production effective de votre application.

L'utilisation de reCAPTCHA nécessite que le client ait accès à Internet puisque les captchas seront directement fournis par le service reCAPTCHA. Le serveur devra lui aussi être relié à Internet puisque c'est lui qui demandera à reCAPTCHA de vérifier si un mot donné résout ou non le captcha. Dans cette solution, le serveur ne fait ni la génération du captcha ni sa vérification, il ne connait jamais les mots cachés dans le captcha.

Comme pour les méthodes précédentes, la mise en œuvre est très simple :

<html>
<head>
</head>
<body><?php 
 
require_once 'Zend/Loader/Autoloader.php';
Zend_Loader_Autoloader::getInstance()->registerNamespace('Zend_');
 
// instanciation
$captcha = new Zend_Service_ReCaptcha(
    "votre clef publique",
    "votre clef privée"
);
// paramétrage
$captcha->setOptions(array(
            'theme'=>'clean',
            'lang'=>'fr'
        ));
 
if (!isset($_POST['recaptcha_challenge_field'])){
 
}else{
 
    // vérification
    $captchaResult = $captcha->verify(
                $_POST['recaptcha_challenge_field'],
                $_POST['recaptcha_response_field']
            );
 
    if ($captchaResult->isValid()){
        echo '<img src="ok.gif" />';
    }else{
        echo '<img src="ko.png"/>';
    }
}
?>
 
<form method="post">
 
<?php echo $captcha->getHtml () ?>
 
<input type="submit"/>
 
</form>
 
</body>
</html>

On remarque que la vérification se fait sur des champs POST nommés recaptcha_challenge_field et recaptcha_response_field. Ces deux champs sont positionnés par l'outil reCAPTCHA et sont générés lors de l'appel à $captcha->getHtml(). Ce n'est pas à vous de les générer.

Le développeur n'a pas beaucoup de possibilités pour paramétrer le captcha reCAPTCHA : à part le look dudit captcha, pas grand-chose. Voici les quatre looks existants :

Tous les captchas gérés par Zend implémentent Zend_Captcha_Adapter, ils peuvent ainsi tous êtes ajoutés à un Zend_Form de la même manière via un Zend_Form_Element_Captcha. Exemple :

$form = new Zend_Form();
 
// construction du Zend_Form avec tous les champs nécessaires
$form->addElement(...);
...
 
//  création du captcha
$captcha = new Zend_Form_Element_Captcha('captcha', array(
    'label' => "Merci de confirmer que vous êtes humain",
 
    // paramétrage en reprenant les noms de méthodes vus précédemment
    'captcha' => array(
        "captcha" => "Image",
        "wordLen" => 8,
        "font" => "./tahoma.ttf",
        "height" => 100,
        "width" => 300,
        "fontSize" => 50,
        "imgDir" => "out/",
        "imgUrl" => "out/"
    )
));
 
$form->addElement($captcha);
 
// suite du rendu du Zend_Form

La validation du formulaire se fera via $form->isValid($_POST), l'utilisation du captcha devient complètement transparente, le développeur n'a plus à la gérer manuellement.