repo_zf1/documentation/manual/de/module_specs/Zend_Currency-Migrating.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 16181 -->
<!-- Reviewed: no -->
<sect1 id="zend.currency.migration">

    <title>Migration von vorhergehenden Versionen</title>

    <para>
        Die API von <classname>Zend_Currency</classname> wurde in der Vergangenheit verändert
        um die Usability zu verbessern. Wenn <classname>Zend_Currency</classname> schon mit einer
        Version verwendet wurde die in diesem Kapitel erwähnt wird sollte den
        unten stehenden Anweisungen gefolgt werden um die eigenen Skripte zur neuen
        API zu migrieren.
    </para>

    <sect2 id="zend.currency.usage.migration.fromonezerotwo">

        <title>Von 1.0.2 zu 1.0.3 oder neuer migrieren</title>

        <para>
            Die Erstellung von <classname>Zend_Currency</classname> wurde vereinfacht.
            Es muß nicht länger ein Skript angegeben oder auf null gesetzt werden.
            Der optionale script Parameter ist jetzt eine Option welche durch die
            <methodname>setFormat()</methodname> Methode gesetzt werden kann.
        </para>

        <programlisting language="php"><![CDATA[
$currency = new Zend_Currency($currency, $locale);
]]></programlisting>

        <para>
            Die <methodname>setFormat()</methodname> Methode nimmt jetzt ein Array von Optionen.
            Diese Optionen werden permanent gesetzt und überschreiben alle vorher gesetzten Werte.
            Auch eine neue Option 'precision' wurde integriert. Die folgenden Optionen wurden
            überarbeitet:

            <itemizedlist mark='opencircle'>
                <listitem>
                    <para>
                        <emphasis>position</emphasis>:
                        Ersetzt den alten 'rules' Parameter.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis>script</emphasis>:
                        Ersetzt den alten 'script' Parameter.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis>format</emphasis>:
                        Ersetzt den alten 'locale' Parameter welcher keine neue Währung, sondern
                        nur das Format der Nummern setzt.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis>display</emphasis>:
                        Ersetzt den alten 'rules' Parameter.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis>precision</emphasis>:
                        Neuer Parameter.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis>name</emphasis>: Ersetzt den alten 'rules' Parameter. Setzt den
                        vollständigen Namen der Währung.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis>currency</emphasis>:
                        Neuer Parameter.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <emphasis>symbol</emphasis>:
                        Neuer Parameter.
                    </para>
                </listitem>
            </itemizedlist>

        </para>

        <programlisting language="php"><![CDATA[
$currency->setFormat(array $options);
]]></programlisting>

        <para>
            Die <methodname>toCurrency()</methodname> Methode unterstützt die optionalen 'script'
            und 'locale' Parameter nicht mehr. Stattdessen nimmt sie ein Array von Optionen welche
            die selben Schlüssel enthalten können wie die <methodname>setFormat()</methodname>
            Methode.
        </para>

        <programlisting language="php"><![CDATA[
$currency->toCurrency($value, array $options);
]]></programlisting>

        <para>
            Die Methoden <methodname>getSymbol()</methodname>,
            <methodname>getShortName()</methodname>, <methodname>getName()</methodname>,
            <methodname>getRegionList()</methodname> und <methodname>getCurrencyList()</methodname>
            sind nicht länger statisch und können vom Objekt aus aufgerufen werden. Die geben den
            aktuell gesetzten Wert des Objekts zurück wenn kein Parameter gesetzt wurde.
        </para>

    </sect2>

</sect1>