repo_zf1/documentation/manual/de/module_specs/Zend_Cache-Backends.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15207 -->
<!-- Reviewed: no -->
<sect1 id="zend.cache.backends">
    <title>Zend_Cache Backends</title>
    <para>
        Es gibt zwei Arten von Backends: Standard und erweiterte. Natürlich bieten erweiterte Backends
        mehr Features.
    </para>

    <sect2 id="zend.cache.backends.file">
        <title>Zend_Cache_Backend_File</title>
        <para>
            Dieses (erweiterte) Backend speichert Cache Datensätze in Dateien (in einem gewählten Verzeichnis).
        </para>
        <para>
            Mögliche Optionen sind :
        </para>
        <table id="zend.cache.backends.file.table">
            <title>File Backend Optionen</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>Option</entry>
                        <entry>Daten Typ</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><code>cache_dir</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>'/tmp/'</code></entry>
                          <entry>
                              Verzeichnis, in dem die Cache Dateien gespeichert werden
                          </entry>
                      </row>
                      <row>
                          <entry><code>file_locking</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>true</code></entry>
                          <entry>
                            Ein- / Ausschalten von file_locking: kann die Beschädigung des Caches
                            unter schlechten Bedingungen verhindern, aber es hilft nicht bei
                            Multithreaded Webservern oder bei NFS Filesystemen...
                          </entry>
                      </row>
                      <row>
                          <entry><code>read_control</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>true</code></entry>
                          <entry>
                            Ein- / Ausschalten von read_control: eingeschaltet wird ein Kontrollschlüssel
                            im Cache File inkludiert und dieser Schlüssel wird mit dem Schlüssel
                            verglichen, der nach dem Lesen berechnet wird.
                          </entry>
                      </row>
                      <row>
                          <entry><code>read_control_type</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>'crc32'</code></entry>
                          <entry>
                            Typ der Schreibkontrolle (nur wenn read_control eingeschaltet ist).
                            Mögliche Werte sind :
                            'md5' (bestes, aber am Langsamsten), 'crc32' (etwas weniger sicher, aber schneller,
                            beste Wahl), 'adler32' (neue Wahl, schneller als crc32), 'strlen' um nur die Länge
                            zu testen (schnellstes).
                        </entry>
                      </row>
                      <row>
                          <entry><code>hashed_directory_level</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>0</code></entry>
                          <entry>
                             Level der gehashten Verzeichnis Struktur: 0 heißt "keine gehashte
                             Verzeichnis Strutur, 1 heißt "ein Level von Verzeichnissen", 2 heißt
                             "zwei Levels"...
                             Diese Option kann den Cache nur dann schneller machen, wenn viele Tausende
                             Cache Dateien verwendet werden. Nur spezielle Messungen können helfen, den perfekten
                             Wert zu finden. Möglicherweise ist 1 oder 2 ein guter Anfang.
                          </entry>
                      </row>
                      <row>
                          <entry><code>hashed_directory_umask</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>0700</code></entry>
                          <entry>
                              Umask für die gehashte Verzeichnis Struktur
                        </entry>
                      </row>
                      <row>
                          <entry><code>file_name_prefix</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>'zend_cache'</code></entry>
                          <entry>
                              Präfix für Cache Dateien; man muss mit dieser Option sehr vorsichtig
                              umgehen, weil ein zu generischer Wert in einem System Cache Verzeichnis
                              (wie /tmp) kann beim Löschen des Caches zu großen Problemen führen.
                        </entry>
                      </row>
                      <row>
                          <entry><code>cache_file_umask</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>0700</code></entry>
                          <entry>
                              umask nach Cache Dateien
                          </entry>
                      </row>
                       <row>
                          <entry><code>metatadatas_array_max_size</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>100</code></entry>
                          <entry>
                              Interne maximale Größe für das Metadaten Array (dieser Wert sollte nicht
                              geändert werden außer man weiß was man macht)
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.sqlite">
        <title>Zend_Cache_Backend_Sqlite</title>
        <para>
            Dieses (erweiterte) Backend speichert die Cache Datensätze in einer SQLite Datenbank.
        </para>
        <para>
            Mögliche Optionen sind :
        </para>
        <table id="zend.cache.backends.sqlite.table">
            <title>Sqlite Backend Optionen</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                           <entry>Option</entry>
                        <entry>Daten Typ</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><code>cache_db_complete_path (mandatory)</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>null</code></entry>
                          <entry>
                              Der komplette Pfad (inklusive Dateiname) der SQLite Datenbank
                          </entry>
                      </row>
                      <row>
                          <entry><code>automatic_vacuum_factor</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>10</code></entry>
                          <entry>
                              Deaktiviere / stelle den automatischen Vakuumprozess ein.
                              Der automatische Vakuumprozess defragmentiert die Datenbankdatei (und
                              verkleinert sie) wenn clean() oder delete() aufgerufen wird:
                              0 bedeutet kein automatisches Vakuum;
                              1 bedeutet systematisches Vakuum (wenn die delete() or clean() Methoden aufgerufen werden;
                              x (integer) > 1 => automatisches Vakuum zufällig einmal pro x clean() oder delete() Aufrufe.
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.memcached">
        <title>Zend_Cache_Backend_Memcached</title>
        <para>
            Dieses (erweiterte) Backend speichert Cache Datensätze in einem Memcached Server. <ulink url="http://www.danga.com/memcached/">memcached</ulink>
            ist ein hoch-performantes, verteiltes Speicher Objekt Caching System. Um dieses Backend zu benutzen,
            wird ein Memcached Dämon benötigt und <ulink url="http://pecl.php.net/package/memcache">die Memcached PECL Erweiterung</ulink>.
        </para>
        <para>
            Vorsicht: mit diesem Backend werden zur Zeit "Marker" nicht unterstützt genauso wie das
            "doNotTestCacheValidity=true" Argument.
        </para>
        <para>
            Mögliche Optionen sind :
        </para>
        <table id="zend.cache.backends.memcached.table">
            <title>Memcached Backend Optionen</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>Option</entry>
                        <entry>Daten Typ</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><code>servers</code></entry>
                          <entry><code>array</code></entry>
                          <entry>
                              <code>
                                  array(array('host' => 'localhost','port' => 11211, 'persistent' => true, 'weight' => 1,
                                  'timeout' => 5, 'retry_interval' => 15, 'status' => true, 'failure_callback' => '' ))
                              </code>
                          </entry>
                          <entry>
                              Ein Array von Memcached Servern; jeder Memcached Server wird durch ein
                              assoziatives Array beschrieben :
                              'host' => (string) : Der Name des Memcached Servers,
                              'port' => (int) : Der Port des Memcached Servers,
                              'persistent' => (bool) : Persistente Verbindungen für diesen Memcached Server verwenden oder nicht
                              'weight' => (int) : Das Gewicht des Memcached Servers,
                              'timeout' => (int) : Das Timeout des Memcached Servers,
                              'retry_interval' => (int) : Das Wiederholungsintervall des Memcached Servers,
                              'status' => (bool) : Der Status des Memcached Servers,
                              'failure_callback' => (callback) : Der failure_callback des Memcached Servers
                          </entry>
                      </row>
                      <row>
                          <entry><code>compression</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>false</code></entry>
                          <entry>
                             true wenn on-the-fly Kompression verwendet werden soll
                          </entry>
                      </row>
                      <row>
                          <entry><code>compatibility</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>false</code></entry>
                          <entry>
                             true wenn man den Compatibility Modus mit alten Memcache Servern/Erweiterungen
                             verwenden will
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.apc">
        <title>Zend_Cache_Backend_Apc</title>
        <para>
            Dieses (erweiterte) Backend speichert Cache Datensätze im Shared Memory durch die
            <ulink url="http://pecl.php.net/package/APC">APC</ulink> (Alternativer PHP Cache) Erweiterung
            (welche natürlich für die Verwendung dieses Backends benötigt wird).
        </para>
        <para>
            Vorsicht: mit diesem Backend werden "Marker" zur Zeit nicht unterstützt genauso wie das
            "doNotTestCacheValidity=true" Argument.
        </para>
        <para>
            Es gibt keine Optionen für dieses Backend.
        </para>
    </sect2>
    <sect2 id="zend.cache.backends.xcache">
        <title>Zend_Cache_Backend_Xcache</title>
        <para>
            Dieses Backend speichert Cache Einträge im Shared Memory durch die
            <ulink url="http://xcache.lighttpd.net/">XCache</ulink> Erweiterung (welche natürlich
            benötigt wird, damit dieses Backend verwendet werden kann).
        </para>
        <para>
            Achtung: Bei diesem Backend werden "tags" aktuell nicht unterstützt sowie das
            "doNotTestCacheValidity=true" Argument.
        </para>
        <para>
            Mögliche Optionen sind:
        </para>
        <table id="zend.cache.backends.xcache.table">
            <title>Xcache backend options</title>
            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Option</entry>
                        <entry>Daten Typ</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry><code>user</code></entry>
                        <entry><code>string</code></entry>
                        <entry><code>null</code></entry>
                        <entry>
                              xcache.admin.user, notwendig für die clean() Methode
                        </entry>
                    </row>
                    <row>
                        <entry><code>password</code></entry>
                        <entry><code>string</code></entry>
                        <entry><code>null</code></entry>
                        <entry>
                              xcache.admin.pass (in offener Form, nicht MD5), notwendig für die clean() Methode
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>
    <sect2 id="zend.cache.backends.platform">
        <title>Zend_Cache_Backend_ZendPlatform</title>
        <para>
            Dieses Backend verwendet die Content Caching API des
            <ulink url="http://www.zend.com/products/platform">Zend Platform</ulink> Produktes.
            Natürlich muss man die Zend Platform installiert haben, um dieses Backend verwenden zu
            können.
        </para>
        <para>
            Dieses Backend unterstützt Tags, aber nicht den <code>CLEANING_MODE_NOT_MATCHING_TAG</code>
            Löschmodus.
        </para>
        <para>
            Bei Definition dieses Backends muß ein Trennzeichen -- '-', '.', ' ', oder '_'
            -- zwischen den Wörtern 'Zend' und 'Platform' definiert sein wenn die
            <classname>Zend_Cache::factory()</classname> Methode verwendet wird:
        </para>
        <programlisting role="php"><![CDATA[
$cache = Zend_Cache::factory('Core', 'Zend Platform');
]]></programlisting>
        <para>
            Es gibt keine Optionen für dieses Backend.
        </para>
    </sect2>
    <sect2 id="zend.cache.backends.twolevels">
        <title>Zend_Cache_Backend_TwoLevels</title>
        <para>
            Dieses (erweiterte) Backend ist ein Hybrides. Es speichert Cache Einträge in zwei anderen
            Backends: Ein schnelles (aber limitiertes) wie Apc, Memcache... und ein "langsames" wie
            File, Sqlite...
        </para>
        <para>
            Dieses Backend verwendet den Priority Parameter (der auf Frontend Level angegeben wird wenn ein
            Eintrag gespeichert wird) und den verbleibenden Platz im schnellen Backend um die Verwendung
            dieser zwei Backends zu optimieren.
            FIXME
        </para>
        <para>
            Vorhandene Optionen sind:
        </para>
        <table id="zend.cache.backends.twolevels.table">
            <title>TwoLevels Backend Optionen</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>Option</entry>
                        <entry>Datentyp</entry>
                        <entry>Standardwert</entry>
                        <entry>Beschreibung</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><code>slow_backend</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>File</code></entry>
                          <entry>
                              Der "langsame" Backendname
                          </entry>
                      </row>
                      <row>
                          <entry><code>fast_backend</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>Apc</code></entry>
                          <entry>
                              Der "schnelle" Backendname
                          </entry>
                      </row>
                      <row>
                          <entry><code>slow_backend_options</code></entry>
                          <entry><code>array</code></entry>
                          <entry><code>array()</code></entry>
                          <entry>
                              Die "langsamen" Backendoptionen
                          </entry>
                      </row>
                      <row>
                          <entry><code>fast_backend_options</code></entry>
                          <entry><code>array</code></entry>
                          <entry><code>array()</code></entry>
                          <entry>
                              Die "schnellen" Backendoptionen
                          </entry>
                      </row>
                      <row>
                          <entry><code>slow_backend_custom_naming</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>false</code></entry>
                          <entry>
                              Wenn true, wird das slow_backend Argument als kompletter Klassenname verwendet;
                              wenn false, wird das frontend Argument als Ende des
                              "Zend_Cache_Backend_[...]" Klassennamens verwendet
                          </entry>
                      </row>
                      <row>
                          <entry><code>fast_backend_custom_naming</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>false</code></entry>
                          <entry>
                              Wenn true, wird das fast_backend Argument als kompletter Klassenname verwendet;
                              wenn false, wird das frontend Argument als Ende des
                              "Zend_Cache_Backend_[...]" Klassennamens verwendet
                          </entry>
                      </row>
                      <row>
                          <entry><code>slow_backend_autoload</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>false</code></entry>
                          <entry>
                              Wenn true, wird kein require_once für das langsame Backend verwendet
                              (nur für eigene Backends nützlich)
                          </entry>
                      </row>
                      <row>
                          <entry><code>fast_backend_autoload</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>false</code></entry>
                          <entry>
                              Wenn true, wird kein require_once für das schnelle Backend verwendet
                              (nur für eigene Backends nützlich)
                          </entry>
                      </row>
                      <row>
                          <entry><code>auto_refresh_fast_cache</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>true</code></entry>
                          <entry>
                              Wenn true, wird der schnelle Cache automatisch refresht wenn ein Cache
                              Eintrag getroffen wird
                          </entry>
                      </row>
                      <row>
                          <entry><code>stats_update_factor</code></entry>
                          <entry><code>integer</code></entry>
                          <entry><code>10</code></entry>
                          <entry>
                              Ausschalten / Feintunen der Berechnung des Füll-Prozentsatzes des
                              schnellen Backends (wenn ein Eintrag in den Cache gespeichert wird, die
                              Berechnung des Füll-Prozentsatzes des schnellen Backends zufällig 1 mal bei
                              x Cache Schreibvorgängen)
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.zendserver">
        <title>Zend_Cache_Backend_ZendServer_Disk und Zend_Cache_Backend_ZendServer_ShMem</title>
        <para>
            Diese Backends speichern Cacheeinträge indem Sie die Caching Funktionalitäten von
            <ulink url="http://www.zend.com/en/products/server/downloads-all?zfs=zf_download">Zend Server</ulink>
            verwenden.
        </para>
        <para>
            Achtung: mit diesen Backends werden für den Moment "Tags" nicht unterstützt, wegen dem
            "doNotTestCacheValidity=true" Argument.
        </para>
        <para>
            Diese Backends arbeiten nur nur in einer Zend Server Umgebung für Seiten die über
            HTTP(S) angefragt wurden und nicht für Kommandozeilen Ausführung.
        </para>
        <para>
            Es gibt keine Optionen für diese Backends.
        </para>
    </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
+-->