repo_zf1/documentation/manual/de/module_specs/Zend_Serializer-Adapter.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20818 -->
<!-- Reviewed: no -->
<sect1 id="zend.serializer.adapter">
    <title>Zend_Serializer_Adapter</title>

    <para>
        <classname>Zend_Serializer</classname> Adapter erzeugen eine Brücke für unterschiedliche
        Methoden der Serialisierung mit geringem Aufwand.
    </para>

    <para>
        Jeder Adpater hat andere Vor- und Nachteile. In einigen Fällen kann nicht jeder PHP
        Datentyp (z.B. Objekte) in die Repräsentation eines Strings konvertiert werden. In den
        meisten dieser Fälle wird der Typ in einen ähnlichen Typ konvertiert der serialisierbar
        ist -- zum Beispiel werden PHP Objekte oft zu Arrays gecastet. Wenn dies fehlschlägt wird
        eine <classname>Zend_Serializer_Exception</classname> geworfen.
    </para>

    <para>
        Anbei ist eine Liste der vorhandenen Adapter.
    </para>

    <sect2 id="zend.serializer.adapter.phpserialize">
        <title>Zend_Serializer_Adapter_PhpSerialize</title>

        <para>
            Dieser Adapter verwendet die eingebauten PHP Funktionen
            <methodname>un/serialize</methodname> und ist eine gute Wahl für einen Standardadapter.
        </para>

        <para>
            Es gibt keine konfigurierbaren Optionen für diesen Adapter.
        </para>
    </sect2>

    <sect2 id="zend.serializer.adapter.igbinary">
        <title>Zend_Serializer_Adapter_Igbinary</title>

        <para>
            <ulink url="http://opensource.dynamoid.com">Igbinary</ulink> ist eine Open Source
            Software welche von Sulake Dynamoid Oy herausgegeben wird. Statt Zeit und Platz auf
            eine textuelle Repräsentation zu verschwenden, speichert igbinary Datenstrukturen von
            PHP in einer kompakten binären Form. Die Einsparungen sind signifikant wenn memcached
            oder ähnliche Hauptspeicher-basierte Speicher für die serialisierung der Daten verwendet
            wird.
        </para>

        <para>
            Man muss die PHP Erweiterung igbinary am eigenen System installiert haben um diesen
            Adapter verwenden zu können.
        </para>

        <para>
            Dieser Adapter nimnt keine Optionen zur Konfiguration an.
        </para>
    </sect2>

    <sect2 id="zend.serializer.adapter.wddx">
        <title>Zend_Serializer_Adapter_Wddx</title>

        <para>
            <ulink url="http://wikipedia.org/wiki/WDDX">WDDX</ulink> (Web Distributed Data eXchange)
            ist eine Programmier-Sprache-, Plattform- und ein transport-neutraler datentauschender
            Mechanismus für die Übergabe von Daten zwischen unterschiedlichen Umgebungen und
            unterschiedlichen Computern.
        </para>

        <para>
            Der Adapter verwendet einfach die <ulink
                url="http://php.net/manual/book.wddx.php">wddx_*()</ulink> PHP Funktionen. Lesen Sie
            bitte im PHP Handbuch um herauszufinden ob man Sie in der eigenen PHP Installation
            aktivieren kann.
        </para>

        <para>
            Zusätzlich wird die PHP Erweiterung <ulink
                url="http://php.net/manual/book.simplexml.php">SimpleXML</ulink> verwendet um zu
            prüfen ob ein von  <methodname>wddx_unserialize()</methodname> zurückgegebener
            <constant>NULL</constant> Wert auf einem serialisierten <constant>NULL</constant> Wert
            basiert, oder auf ungültigen Daten.
        </para>

        <para>
            Vorhandene Optionen sind:
        </para>

        <table id="zend.serializer.adapter.wddx.table.options">
            <title>Optionen für Zend_Serializer_Adapter_Wddx</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Option</entry>
                        <entry>Datentyp</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><emphasis>comment</emphasis></entry>
                        <entry><type>string</type></entry>
                        <entry></entry>
                        <entry>Ein optionales Kommentar welches im Paket Header vorkommt.</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>

    <sect2 id="zend.serializer.adapter.json">
        <title>Zend_Serializer_Adapter_Json</title>

        <para>
            Der <acronym>JSON</acronym> Adapter bietet eine Brücke zur Komponente
            <classname>Zend_Json</classname> und zu ext/json. Lesen Sie bitte die <link
                linkend= "zend.json.introduction">Zend_Json Dokumentation</link> für weitere
            Informationen.
        </para>

        <para>
            Vorhandene Optionen sind:
        </para>

        <table id="zend.serializer.adapter.json.table.options">
            <title>Optionen für Zend_Serializer_Adapter_Json</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Option</entry>
                        <entry>Datentyp</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><emphasis>cycleCheck</emphasis></entry>
                        <entry><type>boolean</type></entry>
                        <entry>false</entry>
                        <entry>Siehe <xref linkend= "zend.json.advanced.objects1"/></entry>
                    </row>

                    <row>
                        <entry><emphasis>objectDecodeType</emphasis></entry>
                        <entry><type>Zend_Json::TYPE_*</type></entry>
                        <entry>Zend_Json::TYPE_ARRAY</entry>
                        <entry>Siehe <xref linkend= "zend.json.advanced.objects1"/></entry>
                    </row>

                    <row>
                        <entry><emphasis>enableJsonExprFinder</emphasis></entry>
                        <entry><type>boolean</type></entry>
                        <entry>false</entry>
                        <entry>Siehe <xref linkend= "zend.json.advanced.expr"/></entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>

    <sect2 id="zend.serializer.adapter.amf03">
        <title>Zend_Serializer_Adapter_Amf 0 und 3</title>

        <para>
            Die <acronym>AMF</acronym> Adapter <classname>Zend_Serializer_Adapter_Amf0</classname>
            und <classname>Zend_Serializer_Adapter_Amf3</classname> bieten eine Brücke zum
            Serialisierer der Komponente <classname>Zend_Amf</classname>. Lesen Sie bitte die <link
                linkend= "zend.amf.introduction">Zend_Amf Dokumentation</link> für weitere
            Informationen.
        </para>

        <para>
            Es gibt keine Optionen für diese Adapter.
        </para>
    </sect2>

    <sect2 id="zend.serializer.adapter.pythonpickle">
        <title>Zend_Serializer_Adapter_PythonPickle</title>

        <para>
            Dieser Adapter konvertiert PHP Typen in eine <ulink
                url="http://docs.python.org/library/pickle.html">Python Pickle</ulink> String
            Repräsentation. Mit Ihm können die serialisierten Daten mit Python gelesen werden und
            Pickled Daten von Python mit PHP gelesen werden.
        </para>

        <para>
            Vorhandene Optionen sind:
        </para>

        <table id="zend.serializer.adapter.pythonpickle.table.options">
            <title>Optionen für Zend_Serializer_Adapter_PythonPickle</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Option</entry>
                        <entry>Datentyp</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><emphasis>protocol</emphasis></entry>
                        <entry><type>integer</type> (0 | 1 | 2 | 3)</entry>
                        <entry>0</entry>

                        <entry>
                            Die Version des Pickle Protokolls welches bei
                            <methodname>serialize</methodname> verwendet wird
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <para>
            Der Wechsel von Datentypen (PHP zu Python) findet wie folgt statt:
        </para>

        <table id="zend.serializer.adapter.pythonpickle.table.php2python">
            <title>Wechseln des Datentyps (PHP zu Python)</title>

            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>PHP Typ</entry>
                        <entry>Python Typ</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><type>NULL</type></entry>
                        <entry><type>None</type></entry>
                    </row>

                    <row>
                        <entry><type>boolean</type></entry>
                        <entry><type>boolean</type></entry>
                    </row>

                    <row>
                        <entry><type>integer</type></entry>
                        <entry><type>integer</type></entry>
                    </row>

                    <row>
                        <entry><type>float</type></entry>
                        <entry><type>float</type></entry>
                    </row>

                    <row>
                        <entry><type>string</type></entry>
                        <entry><type>string</type></entry>
                    </row>

                    <row>
                        <entry><type>array</type></entry>
                        <entry><type>list</type></entry>
                    </row>

                    <row>
                        <entry><type>associative array</type></entry>
                        <entry><type>dictionary</type></entry>
                    </row>

                    <row>
                        <entry><type>object</type></entry>
                        <entry><type>dictionary</type></entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <para>
            Der Wechsel von Datentypen (Python zu PHP) findet wie folgt statt:
        </para>

        <table id="zend.serializer.adapter.pythonpickle.table.python2php">
            <title>Wechseln des Datentyps (PHP zu Python)</title>

            <tgroup cols="2">
                <thead>
                    <row>
                        <entry>Python Typ</entry>
                        <entry>PHP Typ</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><type>None</type></entry>
                        <entry><type>NULL</type></entry>
                    </row>

                    <row>
                        <entry><type>boolean</type></entry>
                        <entry><type>boolean</type></entry>
                    </row>

                    <row>
                        <entry><type>integer</type></entry>
                        <entry><type>integer</type></entry>
                    </row>

                    <row>
                        <entry><type>long</type></entry>

                        <entry>
                              <type>integer</type> | <type>float</type> | <type>string</type>
                              | <classname>Zend_Serializer_Exception</classname>
                        </entry>
                    </row>

                    <row>
                        <entry><type>float</type></entry>
                        <entry><type>float</type></entry>
                    </row>

                    <row>
                        <entry><type>string</type></entry>
                        <entry><type>string</type></entry>
                    </row>

                    <row>
                        <entry><type>bytes</type></entry>
                        <entry><type>string</type></entry>
                    </row>

                    <row>
                        <entry><type>Unicode string</type></entry>
                        <entry><type>UTF-8 string</type></entry>
                    </row>

                    <row>
                        <entry><type>list</type></entry>
                        <entry><type>array</type></entry>
                    </row>

                    <row>
                        <entry><type>tuple</type></entry>
                        <entry><type>array</type></entry>
                    </row>

                    <row>
                        <entry><type>dictionary</type></entry>
                        <entry><type>associative array</type></entry>
                    </row>

                    <row>
                        <entry>Alle anderen Typen</entry>
                        <entry><classname>Zend_Serializer_Exception</classname></entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>

    <sect2 id="zend.serializer.adapter.phpcode">
        <title>Zend_Serializer_Adapter_PhpCode</title>

        <para>
            Dieser Adapter erzeugt eine Repräsentation an PHP Code der geparst werden kann indem
            <ulink url="http://php.net/manual/function.var-export.php">var_export()</ulink>
            verwendet wird. Bei der Wiederherstellung werden die Daten ausgeführt indem <ulink
                url="http://php.net/manual/function.eval.php">eval</ulink> verwendet wird.
        </para>

        <para>
            Es gibt keine Optionen für die Konfiguration dieses Adapters.
        </para>

        <warning>
            <title>Objekte deserialisieren</title>

            <para>
                Objekte werden serialisiert indem die magische Methode <ulink
                    url="http://php.net/manual/language.oop5.magic.php#language.oop5.magic.set-state">__set_state</ulink>
                verwendet wird. Wenn die Klasse diese Methode nicht implementiert wird wärend der
                Ausführung ein fataler Fehler auftreten.
            </para>
        </warning>

        <warning>
            <title>Verwendet eval()</title>

            <para>
                Der Adapter <classname>PhpCode</classname> verwendet <methodname>eval()</methodname>
                für die Deserialisierung. Das führt sowohl zu Performanz- als auch zu einem
                potentiellen Sicherheitsproblem da ein neuer Prozess ausgeführt wird. Typischerweise
                sollte der Adapter <methodname>PhpSerialize</methodname> verwendet werden solange
                man die Lesbarkeit der serialisierten Daten durch Menschen benötigt.
            </para>
        </warning>
    </sect2>
</sect1>