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

<sect1 id="zend.cache.backends">
    <title>Backendy Zend_Cache</title>

    <sect2 id="zend.cache.backends.file">
        <title>Zend_Cache_Backend_File</title>
        <para>
            Ten backend przechowuje rekordy bufora w plikach (w wybranym katalogu).
        </para>
        <para>
            Dostępne opcje to:
        </para>
        <table id="zend.cache.backends.file.table">
            <title>Opcje backendu File</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>Opcja</entry>
                        <entry>Typ danych</entry>
                        <entry>Domyślna wartość</entry>
                        <entry>Opis</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><code>cache_dir</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>'/tmp/'</code></entry>
                          <entry>
                              Katalog w którym mają być przechowywane pliki bufora.
                          </entry>
                      </row>
                      <row>
                          <entry><code>file_locking</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>true</code></entry>
                          <entry>
                            Włącza / wyłącza file_locking: Może zapobiec uszkodzeniu
                            bufora, ale nie ma to znaczenia w serwerach
                            wielowątkowych lub systemach NFS.
                          </entry>
                      </row>
                      <row>
                          <entry><code>read_control</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>true</code></entry>
                          <entry>
                            Włącza / wyłącza kontrolę odczytu: jeśli włączona, klucz kontrolny
                            jest załączany w pliku bufora i ten klucz jest porównywany
                            z tym obliczonym podczas odczytywania bufora.
                          </entry>
                      </row>
                      <row>
                          <entry><code>read_control_type</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>'crc32'</code></entry>
                          <entry>
                            Typ kontroli odczytu (tylko jeśli kontrola odczytu jest włączona). Dostępne wartości to:
                            'md5' (najlepszy, ale najwolniejszy), 'crc32' (odrobinę mniej bezpieczny, ale szybszy, lepszy wybór),
                            'adler32' (nowy wybór, szybszy niż crc32),
                            'strlen' tylko dla testu długości (najszybszy).
                        </entry>
                      </row>
                      <row>
                          <entry><code>hashed_directory_level</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>0</code></entry>
                          <entry>
                              Poziom haszowanej struktury katalogów: 0 oznacza "brak
                              haszowanej struktury", 1 oznacza "jeden poziom katalogów",
                              2 oznacza "dwa poziomy"... Ta opcja może przyspieszyć
                              buforowanie tylko wtedy gdy masz tysiące plików bufora.
                              Tylko specyficzne testy pomogą Ci wybrać perfekcyjną
                              wartość. Możliwe, że 1 lub 2 jest dobre na początek.
                          </entry>
                      </row>
                      <row>
                          <entry><code>hashed_directory_umask</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>0700</code></entry>
                          <entry>
                              Maska Umask dla haszowanej struktury katalogów.
                        </entry>
                      </row>
                      <row>
                          <entry><code>file_name_prefix</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>'zend_cache'</code></entry>
                          <entry>
                              przedrostek dla plików bufora ; bądź naprawdę ostrożny
                              z tą opcją, ponieważ zbyt prosta wartość w katalogu
                              systemowego bufora (jak np. /tmp) może spowodować
                              niechciane działania podczas czyszczenia bufora.
                          </entry>
                      </row>
                      <row>
                          <entry><code>cache_file_umask</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>0700</code></entry>
                          <entry>
                              maska umask dla plików bufora
                          </entry>
                      </row>
                      <row>
                          <entry><code>metatadatas_array_max_size</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>100</code></entry>
                          <entry>
                              wewnętrzny maksymalny rozmiar tablicy danych meta
                              (nie zmieniaj tej wartości jeśli nie jesteś do
                              końca pewien co robisz)
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.sqlite">
        <title>Zend_Cache_Backend_Sqlite</title>
        <para>
            Ten backend przechowuje rekordy bufora w bazie SQLite.
        </para>
        <para>
            Dostępne opcje to:
        </para>
        <table id="zend.cache.backends.sqlite.table">
            <title>Opcje backendu Sqlite</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>Opcja</entry>
                        <entry>Typ danych</entry>
                        <entry>Domyślna wartość</entry>
                        <entry>Opis</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><code>cache_db_complete_path (wymagana)</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>null</code></entry>
                          <entry>
                              Kompletna ścieżka (wraz z nazwą pliku) bazy danych SQLite
                          </entry>
                      </row>
                      <row>
                          <entry><code>automatic_vacuum_factor</code></entry>
                          <entry><code>int</code></entry>
                          <entry><code>10</code></entry>
                          <entry>
                              Włącza / ustawia proces automatycznego czyszczenia
                              Proces automatycznego czyszczenia defragmentuje plik bazy (i zmniejsza jego rozmiar)
                              gdy wywoływane są metody clean() lub delete():
                              0 oznacza brak automatycznego czyszczenia ;
                              1 oznacza systematyczne czyszczenie (gdy wywoływane są metody delete() lub clean()) ;
                              x (integer) > 1 => automatyczne czyszczenie losow 1 raz na x wywołań clean() lub delete().
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.memcached">
        <title>Zend_Cache_Backend_Memcached</title>
        <para>
            Ten backend przechowuje rekordy bufora w serwerze memcached. <ulink url="http://www.danga.com/memcached/">memcached</ulink>
            jest systemem buforowania w pamięci rozdzielonej o wysokiej wydajności. Aby użyć tego backendu,
            potrzebujesz działającego serwera memcached oraz <ulink url="http://pecl.php.net/package/memcache">rozszerzenia PECL memcache</ulink>.
        </para>
        <para>
            Bądź odstrożny: w tym backendzie nie są obecnie obsługiwane etykiety,
            tak samo jak argument "doNotTestCacheValidity=true".
        </para>
        <para>
            Dostępne opcje to:
        </para>
        <table id="zend.cache.backends.memcached.table">
            <title>Opcje backendu Memcached</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>Opcja</entry>
                        <entry>Typ danych</entry>
                        <entry>Domyślna wartość</entry>
                        <entry>Opis</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))</code></entry>
                          <entry>
                              Tablica serwerów memcached ; każdy serwer memcached jest opisany przez asocjacyjną tablicę :
                              'host' => (string) : nazwa serwera memcached,
                              'port' => (int) : port serwera memcached,
                              'persistent' => (bool) : używać czy nie używać stałych połączeń do tego serwera memcached
                          </entry>
                      </row>
                      <row>
                          <entry><code>compression</code></entry>
                          <entry><code>boolean</code></entry>
                          <entry><code>false</code></entry>
                          <entry>
                             wartość true jeśli chcesz użyć kompresji w locie
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.apc">
        <title>Zend_Cache_Backend_Apc</title>
        <para>
            Ten backend przechowuje rekordy bufora we współdzielonej pamięci za
            pomocą rozszerzenia <ulink url="http://pecl.php.net/package/APC">APC</ulink>
            (Alternatywny bufor PHP), które oczywiście jest wymagane jeśli chcemy
            użyć tego backendu.
        </para>
        <para>
            Bądź odstrożny: w tym backendzie nie są obecnie obsługiwane etykiety,
            tak samo jak argument "doNotTestCacheValidity=true".
        </para>
        <para>
            Ten backend nie ma żadnych opcji.
        </para>
    </sect2>
    <sect2 id="zend.cache.backends.xcache">
        <title>Zend_Cache_Backend_Xcache</title>
        <para>
            Ten backend przechowuje rekordy buforu we współdzielonej pamięci
            za pomocą rozszerzenia <ulink url="http://xcache.lighttpd.net/">XCache</ulink>
            (które oczywiście jest potrzebne aby móc używać tego backendu).
        </para>
        <para>
            Bądź ostrożny : ten backend obecnie nie obsługuje etykiet, podobnie jak
            opcji "doNotTestCacheValidity=true".
        </para>
        <para>
            Dostępne opcje to:
        </para>
        <table id="zend.cache.backends.xcache.table">
            <title>Opcje backendu Xcache</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>Opcja</entry>
                        <entry>Typ danych</entry>
                        <entry>Domyślna wartość</entry>
                        <entry>Opis</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><code>user</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>null</code></entry>
                          <entry>
                              xcache.admin.user, konieczna dla metody clean()
                          </entry>
                      </row>
                      <row>
                          <entry><code>password</code></entry>
                          <entry><code>string</code></entry>
                          <entry><code>null</code></entry>
                          <entry>
                              xcache.admin.pass (w czystej postaci, nie MD5), koieczna dla metody clean()
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.platform">
        <title>Zend_Cache_Backend_ZendPlatform</title>
        <para>
            Ten backend używa API produktu <ulink url="http://www.zend.com/products/platform">Zend Platform</ulink> do buforowania zawartości. Oczywiście aby użyć tego backendu, musisz mieć zainstalowaną aplikację Zend Platform.
        </para>
        <para>
            Ten backend obsługuje etykiety, ale nie obsługuje trybu <code>CLEANING_MODE_NOT_MATCHING_TAG</code> czyszczenia bufora.
        </para>
        <para>
            Gdy określasz nazwę tego backendu podczas użycia metody
            <code>Zend_Cache::factory()</code>, wstaw pomiędzy słowami 'Zend'
            oraz 'Platform' jeden z dozwolonych separatorów wyrazów -- '-',
            '.', ' ', lub '_':
        </para>
        <programlisting role="php"><![CDATA[
$cache = Zend_Cache::factory('Core', 'Zend Platform');
]]>
        </programlisting>
        <para>
            Ten backend nie ma żadnych opcji.
        </para>
    </sect2>
</sect1>