Zend Framework 1.10.9 Manual

Zend_Service_ReCaptcha fournit un client pour le » Service Web reCAPTCHA. D'après le site de reCAPTCHA, "reCAPTCHA est un service gratuit de CAPTCHA qui aide à la numérisation de livres." Chaque reCAPTCHA requière que l'utilisateur saisisse 2 mots, le premier est le CAPTCHA, et le second est issu de texte scanné que les OCR (Optical Character Recognition) ne peuvent identifier.

Pour utiliser le service reCAPTCHA, vous devez » créer un compte et enregistrer un ou plusieurs domaines d'utilisation afin de générer une clé publique et une privée.

Instanciez un objet Zend_Service_ReCaptcha en lui passant vos clés publique et privée :

$recaptcha = new Zend_Service_ReCaptcha($pubKey, $privKey);

Pour rendre le reCAPTCHA, appelez simplement la méthode getHTML() :

echo $recaptcha->getHTML();

Lorsque le formulaire est envoyé, vous devriez recevoir 2 champs 'recaptcha_challenge_field' et 'recaptcha_response_field'. Passez les alors à la méthode verify() :

$result = $recaptcha->verify(
    $_POST['recaptcha_challenge_field'],
    $_POST['recaptcha_response_field']
);

Une fois que vous possédez le résultat, vérifiez sa validité. Il s'agit d'un objet Zend_Service_ReCaptcha_Response qui possède une méthode isValid().

if (!$result->isValid()) {
    // Validation échouée
}

Encore plus simple : utilisez l'adaptateur ReCaptcha de Zend_Captcha, ou utilisez cet adaptateur comme backend pour l'élément formulaire Captcha. Dans ces 2 cas, le rendu et la validation du reCAPTCHA sont assurés pour vous.

Zend_Service_ReCaptcha_MailHide can be used to hide email addresses. It will replace a part of an email address with a link that opens a popup window with a ReCaptcha challenge. Solving the challenge will reveal the complete email address.

In order to use this component you will need » an account, and generate public and private keys for the mailhide API.

// The mail address we want to hide
$mail = 'mail@example.com';

// Create an instance of the mailhide component, passing it your public and private keys as well as
// the mail address you want to hide
$mailHide = new Zend_Service_ReCaptcha_Mailhide();
$mailHide->setPublicKey($pubKey);
$mailHide->setPrivateKey($privKey);
$mailHide->setEmail($mail);

// Display it
print($mailHide);

The example above will display "m...@example.com" where "..." has a link that opens up a popup windows with a ReCaptcha challenge.

The public key, private key and the email address can also be specified in the constructor of the class. A fourth argument also exists that enables you to set some options for the component. The available options are listed in the following table:

The configuration options can be set by sending it as the fourth argument to the constructor or by calling the setOptions($options) which takes an associative array or an instance of Zend_Config.

// Create an instance of the mailhide component, passing it your public and private keys as well as
// well the mail address you want to hide
$mailHide = new Zend_Service_ReCaptcha_Mailhide();
$mailHide->setPublicKey($pubKey);
$mailHide->setPrivateKey($privKey);
$mailHide->setOptions(array(
    'linkTitle' => 'Click me',
    'linkHiddenText' => '+++++',
));

// The addresses we want to hide
$mailAddresses = array(
    'mail@example.com',
    'johndoe@example.com',
    'janedoe@example.com',
);

foreach ($mailAddresses as $mail) {
    $mailHide->setEmail($mail);
    print($mailHide);
}