repo_zf1/documentation/manual/de/module_specs/Zend_Memory-MemoryManager.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15157 -->
<!-- Reviewed: no -->
<sect1 id="zend.memory.memory-manager">
    <title>Memory Manager</title>

    <sect2 id="zend.memory.memory-manager.creation">

        <title>Erstellen eines Memory Manager</title>

        <para>
            Ein neuer Memory Manager (<classname>Zend_Memory_Manager</classname> object)
            kann erstellt werden durch Verwendung der
            <classname>Zend_Memory::factory($backendName [, $backendOprions])</classname>
            Methode.
        </para>

        <para>
            Das erste Argument <code>$backendName</code> ist eine Zeichenkette die
            eine der Backend Implementationen benennt welche durch <classname>Zend_Cache</classname>
            unterstützt werden.
        </para>

        <para>
            Das zweite Argument <code>$backendOptions</code> ist ein optionales
            Array für die Optionen des Backends.
        </para>

        <programlisting role="php"><![CDATA[
$backendOptions = array(
    // Verzeichnis in dem die geswappten Memory Blöcke abgelegt werden
    'cache_dir' => './tmp/'
);

$memoryManager = Zend_Memory::factory('File', $backendOptions);
]]></programlisting>

        <para>
            <classname>Zend_Memory</classname> verwendet <link linkend="zend.cache.backends"><classname>Zend_Cache Backends</classname></link>
            als Speicheranbieter.
        </para>

        <para>
            Der spezielle Name '<code>None</code>' kann als Backend Name verwendet werden,
            zusätzlich zu den Standard <classname>Zend_Cache</classname> Backends.

            <programlisting role="php"><![CDATA[
$memoryManager = Zend_Memory::factory('None');
]]></programlisting>
        </para>

        <para>
            Wenn '<code>None</code>' als Backend Name verwendet wird, dann tauscht der
            Memory Manager niemals die Memory Blöcke. Das ist nützlich wenn man weiß das
            Speicher nicht limitiert ist oder die Gesamtgröße der Objekte nie das
            Speicherlimit erreicht.
        </para>

        <para>
            Das '<code>None</code>' Backend benötigt keine Definition von Optionen.
        </para>

    </sect2>

    <sect2 id="zend.memory.memory-manager.objects-management">

        <title>Memory Objekte verwalten</title>

        <para>
            Diese Sektion beschreibt die Erstellung und Vernichtung von Objekten im
            Memory Manager, und die Einstellungen um das Verhalten des Memory
            Managers zu kontrollieren.
        </para>

        <sect3 id="zend.memory.memory-manager.objects-management.movable">

            <title>Erstellung verschiebbarer Objekte</title>

            <para>
                Verschiebbare Objekte (Objekte, welche verschoben werden können)
                können erstellt werden mit Hilfe der
                <classname>Zend_Memory_Manager::create([$data])</classname> Methode:
                <programlisting role="php"><![CDATA[
$memObject = $memoryManager->create($data);
]]></programlisting>

            </para>

            <para>
                Das <code>$data</code> Argument ist optional und wird verwendet um
                die Objekt Werte zu initialisieren. Wenn das <code>$data</code>
                unterdrückt wird, ist der Wert eine leere Zeichenkette.
            </para>

        </sect3>

        <sect3 id="zend.memory.memory-manager.objects-management.locked">

            <title>Erstellen verschlüsselter Objekte</title>

            <para>
                Verschlüsselte Objekte (Objekte, welche niemals getauscht werden) können
                erstellt werden mit Hilfe der
                <classname>Zend_Memory_Manager::createLocked([$data])</classname> Methode:
                <programlisting role="php"><![CDATA[
$memObject = $memoryManager->createLocked($data);
]]></programlisting>
            </para>

            <para>
                Das <code>$data</code> Argument ist optional und wird verwendet um
                die Objekt Werte zu initialisieren. Wenn das <code>$data</code>
                Argument unterdrückt wird, ist der Wert eine leere Zeichenkette.
            </para>

        </sect3>

        <sect3 id="zend.memory.memory-manager.objects-management.destruction">

            <title>Objekte vernichten</title>

            <para>
                Memory Objekte werden automatische vernichtet und vom Speicher
                entfernt wenn sie ausserhalb des Bereichs sind:

                <programlisting role="php"><![CDATA[
function foo()
{
    global $memoryManager, $memList;

    ...

    $memObject1 = $memoryManager->create($data1);
    $memObject2 = $memoryManager->create($data2);
    $memObject3 = $memoryManager->create($data3);

    ...

    $memList[] = $memObject3;

    ...

    unset($memObject2); // $memObject2 wird hier zerstört

    ...
    // $memObject1 wird hier zerstört
    // Aber das $memObject3 Objekt ist noch immer referenziert
    // durch $memList und ist nicht zerstört
}
]]></programlisting>
            </para>

            <para>
                Das gilt für beide, verschiebbare und verschlüsselte Objekte.
            </para>

        </sect3>

    </sect2>

    <sect2 id="zend.memory.memory-manager.settings">

        <title>Memory Manager Einstellungen</title>

        <sect3 id="zend.memory.memory-manager.settings.memory-limit">

            <title>Memory Limit</title>

            <para>
                Das Memory Limit ist eine Zahl von Bytes die zur Verwendung durch
                geladene verschiebbare Objekte erlaubt ist.
            </para>

            <para>
                Wenn das Laden oder Erstellen eines Objekts ein Überschreiten des
                Limits der Verwendung des Speichers verursachen würde, tauscht der
                Memory Manager einige andere Objekte.
            </para>

            <para>
                Das Memory Limit kann empfangen oder gesetzt werden durch Verwendung
                der <code>getMemoryLimit()</code> und <code>setMemoryLimit($newLimit)</code>
                Methoden:
                <programlisting role="php"><![CDATA[
$oldLimit = $memoryManager->getMemoryLimit(); // Memorylimit in Bytes empfangen
$memoryManager->setMemoryLimit($newLimit);    // Memorylimit in Bytes setzen
]]></programlisting>
            </para>

            <para>
                Ein negativer Wert für das Memory Limit bedeutet 'kein Limit'.
            </para>

            <para>
                Der Standardwert ist zweidrittel des Wertes von '<code>memory_limit</code>'
                in php.ini oder 'kein Limit' (-1) wenn '<code>memory_limit</code>' in der
                php.ini nihct gesetzt ist.
            </para>

        </sect3>

        <sect3 id="zend.memory.memory-manager.settings.min-size">

            <title>MinSize</title>

            <para>
                MinSize ist die minimalste Größe von Memory Objekten, welche vom
                Memory Manager getauscht werden können. Der Memory Manager tauscht
                keine Objekte welche kleiner als dieser Wert sind. Das vermindert die
                Anzahl von Tausch-/Lade- Operationen.
            </para>

            <para>
                Man kann die minimale Größe empfangen oder setzen durch Verwendung der
                <code>getMinSize()</code> und <code>setMinSize($newSize)</code>
                Methoden:
                <programlisting role="php"><![CDATA[
$oldMinSize = $memoryManager->getMinSize();  // MinSize in Bytes empfangen
$memoryManager->setMinSize($newSize);        // MinSize Limit in Bytes setzen
]]></programlisting>
            </para>

            <para>
                Die standardmäßige Wert für die minimale Größe ist 16KB (16384 bytes).
            </para>

        </sect3>

    </sect2>

</sect1>