repo_zf1/documentation/manual/de/module_specs/Zend_Captcha-Adapters.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15207 -->
<!-- Reviewed: no -->
<sect1 id="zend.captcha.adapters">
    <title>CAPTCHA Adapter</title>

    <para>
        Die folgenden Adapter werden mit dem Zend Framework standardmäßig ausgeliefert.
    </para>

    <sect2 id="zend.captcha.adapters.word">
        <title>Zend_Captcha_Word</title>

        <para>
            <classname>Zend_Captcha_Word</classname> ist ein abstrakter Adapter der als Basisklasse
            für die meisten anderen CAPTCHA Adapter fungiert. Er bietet Mutatoren für die
            Spezifizierung der Wortlänge, Session TTL, das Session Namespaceobjekt das verwendet
            werden soll, und die Session Namespaceklasse die für die Persistenz zu verwenden ist
            wenn man <classname>Zend_Session_Namespace</classname> nicht verwenden will.
            <classname>Zend_Captcha_Word</classname> kapselt die Prüflogik.
        </para>

        <para>
            Standardmäßig ist die Wortlänge 8 Zeichen, das Sessiontimeout 5 Minuten und für die
            Persistenz wird <classname>Zend_Session_Namespace</classname> verwendet (wobei der
            Namespace "Zend_Form_Captcha_&lt;captcha ID&gt;" verwendet wird).
        </para>

        <para>
            Zusätzlich zu den Methoden wie vom <classname>Zend_Captcha_Adapter</classname> Interface
            benötigt werden bietet <classname>Zend_Captcha_Word</classname> die folgenden Methoden
            an:
        </para>

        <itemizedlist>
            <listitem><para>
                <code>setWordLen($length)</code> und <code>getWordLen()</code> erlauben es die Länge
                des erzeugten "Wortes" in Zeichen zu spezifizieren, und den aktuellen Wert zu
                erhalten.
            </para></listitem>

            <listitem><para>
                <code>setTimeout($ttl)</code> und <code>getTimeout()</code> erlauben es die
                Lebenszeit des Sessiontokens zu spezifizieren, und den aktuellen Wert er erhalten.
                <code>$ttl</code> sollte in Sekunden spezifiziert sein.
            </para></listitem>

            <listitem><para>
                <code>setSessionClass($class)</code> und <code>getSessionClass()</code> erlauben es
                eine alternative <classname>Zend_Session_Namespace</classname> Implementation zu
                spezifizieren die verwendet werden soll um das CAPTCHA Token persistent zu machen
                und den aktuellen Wert zu bekommen.
            </para></listitem>

            <listitem><para>
                <code>getId()</code> erlaubt es den aktuellen Tokenidentifikator zu erhalten.
            </para></listitem>

            <listitem><para>
                <code>getWord()</code> erlaubt es das erzeugte Wort das mit dem CAPTCHA verwendet
                wird zu erhalten. Es wird das Wort erzeugen wenn es bis dahin noch nicht erstellt
                wurde.
            </para></listitem>

            <listitem><para>
                <code>setSession(Zend_Session_Namespace $session)</code> erlaubt es ein
                Sessionobjekt zu spezifizieren das für die Persistenz des CAPTCHA Tokens verwendet
                wird. <code>getSession()</code> erlaubt es das aktuelle Sessionobjekt zu erhalten.
            </para></listitem>
        </itemizedlist>

        <para>
            Alle Wort CAPTCHAs erlauben es ein Array von Optionen an den Konstruktor zu übergeben,
            oder alternativ dieses an <code>setOptions()</code> zu übergeben. Man kan auch ein
            <classname>Zend_Config</classname> Objekt an <code>setConfig()</code> zu übergeben.
            Standardmäßig können die <code>wordLen</code>, <code>timeout</code>, und
            <code>sessionClass</code> Schlüssel alle verwendet werden. Jede konkrete Implementation
            kann zusätzliche Schlüssel definieren oder die Optionen auf einem anderen Weg verwenden.
        </para>

        <note>
            <para>
                <classname>Zend_Captcha_Word</classname> ist eine abstrakte Klasse und kann nicht
                direkt instanziiert werden.
            </para>
        </note>
    </sect2>

    <sect2 id="zend.captcha.adapters.dumb">
        <title>Zend_Captcha_Dumb</title>

        <para>
            Der <classname>Zend_Captcha_Dumb</classname> Adapter ist fast selbsterklärend. Er bietet
            einen zufälligen String der in umgekehrter Reihenfolge eingegeben werden muß um
            validiert zu werden. Als solches ist es keine gute CAPTCHA Lösung, und sollte nur für
            Testzwecke verwendet werden. Er erweitert <classname>Zend_Captcha_Word</classname>.
        </para>
    </sect2>

    <sect2 id="zend.captcha.adapters.figlet">
        <title>Zend_Captcha_Figlet</title>

        <para>
            Der <classname>Zend_Captcha_Figlet</classname> Adapter verwendet
            <link linkend="zend.text.figlet"><classname>Zend_Text_Figlet</classname></link> um dem
            Benutzer ein Figlet zu präsentieren.
        </para>

        <para>
            Optionen die an den Konstruktor übergeben werden, werden auch an das
            <link linkend="zend.text.figlet">Zend_Text_Figlet</link> Objekt übergeben. Schaue in die
            <link linkend="zend.text.figlet">Zend_Text_Figlet</link> Dokumentation für Details
            darüber welche Konfigurationsoptionen vorhanden sind.
        </para>
    </sect2>

    <sect2 id="zend.captcha.adapters.image">
        <title>Zend_Captcha_Image</title>

        <para>
            Der Zend_Captcha_Image Adapter nimmt das erzeugte Wort und stellt es als Bild dar, führt
            diverse Verzerrungs-Permutationen durch und mach es so schwierig es automatisch zu
            entschlüsseln. Er benötigt die <ulink url="http://php.net/gd">GD Erweiterung</ulink>
            kompiliert mit TrueType oder Freetype Unterstützung. Aktuell kann der Zend_Captcha_Image
            Adapter nur PNG Bilder erzeugen.
        </para>

        <para>
            <classname>Zend_Captcha_Image</classname> erweitert
            <classname>Zend_Captcha_Word</classname>, und bietet zusätzlich die folgenden Methoden:
        </para>

        <itemizedlist>
            <listitem><para>
                <code>setExpiration($expiration)</code> und <code>getExpiration()</code> erlauben es
                eine maximale Lebenszeit zu definieren die das CAPTCHA Bild auf dem Dateisystem
                bleibt. Das ist typischerweise längerer als die Session Lifetime. Die Garbage
                Collection läuft periodisch jedes Mal wenn das CAPTCHA Objekt enthalten ist, und
                löscht die Bilder die abgelaufen sind. Der Wert der Löschung sollte in Sekunden
                angegeben werden.
            </para></listitem>

            <listitem><para>
                <code>setGcFreq($gcFreq)</code> und <code>getGcFreg()</code> erlauben es zu
                spezifizieren wie oft die Garbage Collection laufen soll. Die Garbage Collection
                wird alle <code>1/$gcFreq</code> Aufrufe ausgeführt. Standard ist 100.
            </para></listitem>

            <listitem><para>
                <code>setFont($font)</code> und <code>getFont()</code> erlauben es die Schrift zu
                spezifizieren die man verwenden will. <code>$font</code> sollte ein voll
                qualifizierter Pfad zu der Schriftart-Datei sein. Dieser Wert wird benötigt; das
                CAPTCHA wird wärend der Erzeugung eine Ausnahme werfen wenn die Schriftdatei nicht
                spezifiziert wurde.
            </para></listitem>

            <listitem><para>
                <code>setFontSize($fsize)</code> und <code>getFontSize()</code> erlauben es die
                Schriftgröße in Pixel zu spezifizieren die verwendet wird wenn das CAPTCHA erzeugt
                wird. Der Standardwert ist 24px.
            </para></listitem>

            <listitem><para>
                <code>setHeight($height)</code> und <code>getHeight()</code> erlauben es die Höhe in
                Pixel zu spezifizieren die das erzeugte CAPTCHA Bild haben soll. Der Standardwert
                ist 50px.
            </para></listitem>

            <listitem><para>
                <code>setWidth($width)</code> und <code>getWidth()</code> erlauben es die Breite in
                Pixel zu spezifizieren die das erzeugte Captcha Bild haben soll. Der Standardwert
                ist 200px.
            </para></listitem>

            <listitem><para>
                <code>setImgDir($imgDir)</code> und <code>getImgDir()</code> erlauben es das
                Verzeichnis für das Speicher der CAPTCHA Bilder zu spezifizieren. Der Standardwert
                ist "./images/captcha/", was relativ zum Bootstrapskript zu sehen ist.
            </para></listitem>

            <listitem><para>
                <code>setImgUrl($imgUrl)</code> und <code>getImgUrl()</code> erlauben es den
                Relativen Pfad zum CAPTCHA Bild für die Verwendung im HTML Markup zu spezifizieren.
                Der Standardwert ist "/images/captcha/".
            </para></listitem>

            <listitem><para>
                <code>setSuffix($suffix)</code> und <code>getSuffix()</code> erlauben es die Endung
                des Dateinamens für das CAPTCHA Bild zu spezifizieren. Der Standardwert ist ".png".
                Beachte: Das Ändern dieses Wertes wird den Typ des erzeugten Bildes nicht ändern.
            </para></listitem>
        </itemizedlist>

        <para>
            Alle der obigen Optionen können an den Konstruktor übergeben werden indem einfach der
            Präfix der 'set' Methode entfernt wird und der Anfangsbuchstabe kleingeschrieben wird:
            "suffix", "height", "imgUrl", usw.
        </para>
    </sect2>

    <sect2 id="zend.captcha.adapters.recaptcha">
        <title>Zend_Captcha_ReCaptcha</title>

        <para>
            Der <classname>Zend_Captcha_ReCaptcha</classname> Adapter verwendet
            <link linkend="zend.service.recaptcha">Zend_Service_ReCaptcha</link> um CAPTCHAs zu
            erzeugen und zu prüfen. Es bietet die folgenden Methoden an:
        </para>

        <itemizedlist>
            <listitem><para>
                <code>setPrivKey($key)</code> und <code>getPrivKey()</code> erlauben es den privaten
                Schlüssel zu spezifizieren der für den ReCaptcha Service verwendet werden soll. Er
                muß wärend der Erstellung spezifiziert werden, auch wenn er jederzeit überschrieben
                werden kann.
            </para></listitem>

            <listitem><para>
                <code>setPubKey($key)</code> und <code>getPubKey()</code> erlauben es den
                öffentlichen Schlüssel zu spezifizieren der mit dem ReCaptcha Service verwendet
                werden soll. Er muß wärend der Erstellung spezifiziert werden, auch wenn er
                jederzeit überschrieben werden kann.
            </para></listitem>

            <listitem><para>
                <code>setService(Zend_Service_ReCaptcha $service)</code> und
                <code>getService()</code> erlauben es das ReCaptcha Serviceobjekt zu setzen und
                erhalten.
            </para></listitem>
        </itemizedlist>
    </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->