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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20760 -->
<!-- Reviewed: no -->
<sect1 id="zend.serializer.introduction">
    <title>Einführung</title>

    <para>
        <classname>Zend_Serializer</classname> bietet ein Adapter-basierendes Interface um
        eine speicherbare Repräsentation von PHP Typen durch unterschiedliche Arten zu bieten und
        diese wiederherzustellen.
    </para>

    <example id="zend.serializer.introduction.example.dynamic">
        <title>
            Verwenden des dynamischen Interfaces von <classname>Zend_Serializer</classname>
        </title>

        <para>
            Um einen Serializer zu instanzieren sollte man die Factory Methode mit dem Namen des
            Adapters verwenden:
        </para>

        <programlisting language="php"><![CDATA[
$serializer = Zend_Serializer::factory('PhpSerialize');
// Jetzt ist $serializer eine Instanz von
// Zend_Serializer_Adapter_AdapterInterface, im speziellen
// Zend_Serializer_Adapter_PhpSerialize

try {
    $serialized = $serializer->serialize($data);
    // jetzt ist $serialized ein String

    $unserialized = $serializer->unserialize($serialized);
    // Jetzt ist $data == $unserialized
} catch (Zend_Serializer_Exception $e) {
    echo $e;
}
]]></programlisting>
    </example>

    <para>
        Die Methode <methodname>serialize</methodname> erzeugt einen speicherbaren String. Um diese
        serialisierten Daten wiederherzustellen kann einfach die Methode
        <methodname>unserialize</methodname> aufgerufen werden.
    </para>

    <para>
        Jedesmal wenn ein Fehler bei der  Serialisierung oder Deserialisierung festgestellt wird
        wirft <classname>Zend_Serializer</classname> eine
        <classname>Zend_Serializer_Exception</classname>.
    </para>

    <para>
        Um einen gegebenen Serialisierungs-Adapter zu konfigurieren kann optional ein Array oder
        eine Instanz von <classname>Zend_Config</classname> an die <methodname>factory</methodname>
        oder die Methoden <methodname>un-/serialize</methodname> übergeben werden:
    </para>

    <programlisting language="php"><![CDATA[
$serializer = Zend_Serializer::factory('Wddx', array(
    'comment' => 'serialized by Zend_Serializer',
));

try {
    $serialized = $serializer->serialize($data, array('comment' => 'change comment'));
    $unserialized = $serializer->unserialize(
        $serialized,
        array(/* Optionen für die Deserialisierung */)
    );
} catch (Zend_Serializer_Exception $e) {
    echo $e;
}
]]></programlisting>

    <para>
        Optionen welche an <methodname>factory</methodname> übergeben werden sind für das
        instanzierte Objekt gültig. Man kann diese Optionen verändern indem die
        <methodname>setOption(s)</methodname> Methoden verwendet werden. Um ein oder mehrere
        Optionen für einen einzelnen Aufruf zu verändern, können diese als zweites Argument
        an die Methoden <methodname>serialize</methodname> oder <methodname>unserialize</methodname>
        übergeben werden.
    </para>

    <example id="zend.serializer.introduction.example.static.php">
        <title>Das statische Interface von Zend_Serializer verwenden</title>

        <para>
            Man kann einen spezifischen Serialisierungs-Adapter als standardmäßigen
            Serialisierungs-Adapter für die Verwendung mit <classname>Zend_Serializer</classname>
            registrieren. Standardmäßig wird der Adapter <classname>PhpSerialize</classname>
            registriert. Aber man kann das verändern indem die statische Methode
            <methodname>setDefaultAdapter()</methodname> verwendet wird.
        </para>

        <programlisting language="php"><![CDATA[
Zend_Serializer::setDefaultAdapter('PhpSerialize', $options);
// oder
$serializer = Zend_Serializer::factory('PhpSerialize', $options);
Zend_Serializer::setDefaultAdapter($serializer);

try {
    $serialized   = Zend_Serializer::serialize($data, $options);
    $unserialized = Zend_Serializer::unserialize($serialized, $options);
} catch (Zend_Serializer_Exception $e) {
    echo $e;
}
]]></programlisting>
    </example>
</sect1>