documentation/manual/he/module_specs/Zend_Captcha-Operation.xml

   1 <sect1 id="zend.captcha.operation">
   2     <title>פעולת אנטי-ספאם</title>
   3
   4     <para>
   5         כל האובייקטים המוחשיים של CAPTCHA מיישמים את <code>Zend_Captcha_Adapter</code>, שנראה ככה:
   6     </para>
   7
   8     <programlisting role="php"><![CDATA[
   9 interface Zend_Captcha_Adapter extends Zend_Validate_Interface
  10 {
  11     public function generate();
  12
  13     public function render(Zend_View $view, $element = null);
  14
  15     public function setName($name);
  16
  17     public function getName();
  18
  19     public function getDecorator();
  20
  21     // Additionally, to satisfy Zend_Validate_Interface:
  22     public function isValid($value);
  23
  24     public function getMessages();
  25
  26     public function getErrors();
  27 }
  28 ]]>
  29     </programlisting>
  30
  31     <para>
  32         מתודות ה <code>setName()</code> ו <code>getName()</code> נועדו להגדיר ולהחזיר את המזהה היחודי של ה captcha.
  33         <code>getDecorator()</code> יכול לשמש בתור שימוש באובייקט עיצוב של  Zend_Form, בין אם זה על ידי הזנת השם או החזרת האובייקט של העיצוב עצמו.
  34         כל העבודה החשובה נעשית אבל במתודת <code>generate()</code> ו <code>render()</code>.
  35         <code>generate()</code> נועד כדי ליצור את המפתח היחודי ל captcha. תהליך זה בדרך כלל ישמור את הזהה היחודי הזה ב session או בכל מקום אחר שתוכלו לאחר מכן להשוות מולו.
  36          <code>render()</code> נועד להציג את המידע אשר יאמת את הפרטים מול המזהה היחודי שנשמר קודם לכן, בין אם זה הצגת תמונה, טקסט רנדומלי או בעיה לוגית כלשהי.
  37     </para>
  38
  39     <para>
  40         דוגמא לשימוש סטנדרטי נראה כך:
  41     </para>
  42
  43         <programlisting role="php"><![CDATA[
  44 // Creating a Zend_View instance
  45 $view = new Zend_View();
  46
  47 // Originating request:
  48 $captcha = new Zend_Captcha_Figlet(array(
  49     'name' => 'foo',
  50     'wordLen' => 6,
  51     'timeout' => 300,
  52 ));
  53 $id = $captcha->generate();
  54 echo $captcha->render($view);
  55
  56 // On subsequent request:
  57 // Assume captcha setup as before, and $value is the submitted value:
  58 if ($captcha->isValid($_POST['foo'], $_POST)) {
  59     // Validated!
  60 }
  61 ]]>
  62         </programlisting>
  63 </sect1>
  64 <!--
  65 vim:se ts=4 sw=4 et:
  66 -->