Devenir Membre

PHP

Communauté

Manuels

Divers

Manuel Pear

Text_CAPTCHA

Implémentation des CAPTCHA (Completely Automated Public Turing tests to tell Computers and Humans Apart).

Introduction

Ce paquet fourni les fonctionnalités pour créer un CAPTCHAs (Completely Automated Public Turing tests to tell Computers and Humans Apart). Les fonctionnalités proposées sont:

Créer un CAPTCHA graphique en utilisant GD2
Une architecture de "driver" pluggables en utilisant le pattern factory.
Des informations génériques à propos du CAPTCHA

The package creates CAPTCHAs; due to the stateless nature of the HTTP protocol, the logic to secure a webpage using the package must be specifically implemented. Regardez l'exemple d'utilisation pour des informations détaillées.

Pour le moment, le driver graphique CAPTCHA dépend de Image_Text qui lui même requiert le support TTF qui doit être compilé en dans le PHP.

Exemple

L'exemple qui suit implémente l'utilisation commune d'un CAPTCHA: Soumettre un formulaire de donnée qui ne sera pris en compte que si le CAPTCHA a correctement été résolu.

Exemple 64-1. Créer un CAPTCHA

Le code qui suit crée un CAPTCHA, provides the relevant information for the package, anhd retrieves the CAPTCHA as a PNG image.

<?php
require_once 'Text/CAPTCHA.php';
// Fixons les options du CAPTCHA (la fonte doit exister!)
$imageOptions = array(
'font_size' => 24,
'font_path' => './',
'font_file' => 'COUR.TTF',
'text_color' => '#DDFF99',
'lines_color' => '#CCEEDD',
'background_color' => '#555555'
);
$options = array(
'width' => 200,
'height' => 80,
'output' => 'png',
'imageOptions' => $imageOptions
);
// Générer un nouvel objet Text_CAPTCHA, pour le pilote Image
$c = Text_CAPTCHA::factory('Image');
$retval = $c->init($options);
if (PEAR::isError($retval)) {
printf ('Erreur pendant la génération du CAPTCHA: %s',
$retval->getMessage());
exit;
}
// Récupérer la phrase secrete du CAPTCHA
$_SESSION['phrase'] = $c->getPhrase();
// Prendre l'image CAPTCHA (PNG)
$png = $c->getCAPTCHAAsPNG();
if (PEAR::isError($png)) {
echo 'Erreur pendant la génération du CAPTCHA!';
echo $retval->getMessage();
exit;
}
file_put_contents(md5(session_id()) . '.png', $png
?>

Récupérer le code

Exemple 64-2. Protéger un formulaire avec un CAPTCHA

Le code suivant implémente la fonctionnalité de vérification qu'un CAPTCHA a été correctement ou pas résolu. Pour cela, la phrase du CAPTCHA est stockée dans une variable de session pour conserver la l'information à comparer. Il est important de vider (unset) la session après résolution du CAPTCHA pour éviter une réutilisation de l'ID de session.

<?php
session_start();
$ok = false;
$msg = 'Veuillez introduire dans le champs ci dessous '
. 'le texte qui apparait dans l\'image!';
if ($_SERVER['REQUEST_METHOD'] == 'POST') {
if (isset($_POST['phrase']) && is_string($_POST['phrase']) && isset($_SESSION['phrase']) &&
strlen($_POST['phrase']) > 0 && strlen($_SESSION['phrase']) > 0 &&
$_POST['phrase'] == $_SESSION['phrase']) {
$msg = 'OK!';
$ok = true;
unset($_SESSION['phrase']);
} else {
$msg = 'Veuillez ré-essayer!';
}
unlink(md5(session_id()) . '.png');
}
print "<p>$msg</p>";
if (!$ok) {
// Crée le CAPTCHA comme vu ci-dessus
// et l'envoyer au client
?>

Récupérer le code

Regardez le fichier CAPTCHA_test.php dans le paquet distribué pour un exemple complet et fonctionnel (support GD et TTF requis).

Information about the CAPTCHA and inner workings

Text_CAPTCHA provides information about the CAPTCHA and makes its inner workings accessible using several functions defined in the base class; the specific implementation of them is up to the driver.

init() is used to initialize the CAPTCHA and provide further information, like Image_Text parameters.
_createCAPTCHA() generates the CAPTCHA, but is called internally by init().

getPhrase() returns the CAPTCHA's phrase.
_createPhrase() creates a phrase for the CAPTCHA, but is used internally.
getCAPTCHA() returns the CAPTCHA, the format used depends on the driver implementation.

Remonter