| blob | 41c349d52627c3f9769f78372eac697a3ea404ff |
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!-- Reviewed: no -->
3 <sect1 id="zend.cache.backends">
4 <title>Backendy Zend_Cache</title>
6 <sect2 id="zend.cache.backends.file">
7 <title>Zend_Cache_Backend_File</title>
8 <para>
9 Ten backend przechowuje rekordy bufora w plikach (w wybranym katalogu).
10 </para>
11 <para>
12 Dostępne opcje to:
13 </para>
14 <table id="zend.cache.backends.file.table">
15 <title>Opcje backendu File</title>
16 <tgroup cols="4">
17 <thead>
18 <row>
19 <entry>Opcja</entry>
20 <entry>Typ danych</entry>
21 <entry>Domyślna wartość</entry>
22 <entry>Opis</entry>
23 </row>
24 </thead>
25 <tbody>
26 <row>
27 <entry><emphasis>cache_dir</emphasis></entry>
28 <entry><type>String</type></entry>
29 <entry><filename>'/tmp/'</filename></entry>
30 <entry>
31 Katalog w którym mają być przechowywane pliki bufora.
32 </entry>
33 </row>
34 <row>
35 <entry><emphasis>file_locking</emphasis></entry>
36 <entry><type>Boolean</type></entry>
37 <entry><constant>TRUE</constant></entry>
38 <entry>
39 Włącza / wyłącza file_locking: Może zapobiec uszkodzeniu
40 bufora, ale nie ma to znaczenia w serwerach
41 wielowątkowych lub systemach NFS.
42 </entry>
43 </row>
44 <row>
45 <entry><emphasis>read_control</emphasis></entry>
46 <entry><type>Boolean</type></entry>
47 <entry><code>TRUE</code></entry>
48 <entry>
49 Włącza / wyłącza kontrolę odczytu: jeśli włączona, klucz kontrolny
50 jest załączany w pliku bufora i ten klucz jest porównywany
51 z tym obliczonym podczas odczytywania bufora.
52 </entry>
53 </row>
54 <row>
55 <entry><emphasis>read_control_type</emphasis></entry>
56 <entry><type>String</type></entry>
57 <entry><constant>'crc32'</constant></entry>
58 <entry>
59 Typ kontroli odczytu (tylko jeśli kontrola odczytu jest włączona). Dostępne wartości to:
60 'md5' (najlepszy, ale najwolniejszy), 'crc32' (odrobinę mniej bezpieczny, ale szybszy, lepszy wybór),
61 'adler32' (nowy wybór, szybszy niż crc32),
62 'strlen' tylko dla testu długości (najszybszy).
63 </entry>
64 </row>
65 <row>
66 <entry><emphasis>hashed_directory_level</emphasis></entry>
67 <entry><type>Integer</type></entry>
68 <entry>0</entry>
69 <entry>
70 Poziom haszowanej struktury katalogów: 0 oznacza "brak
71 haszowanej struktury", 1 oznacza "jeden poziom katalogów",
72 2 oznacza "dwa poziomy"... Ta opcja może przyspieszyć
73 buforowanie tylko wtedy gdy masz tysiące plików bufora.
74 Tylko specyficzne testy pomogą Ci wybrać perfekcyjną
75 wartość. Możliwe, że 1 lub 2 jest dobre na początek.
76 </entry>
77 </row>
78 <row>
79 <entry><emphasis>hashed_directory_umask</emphasis></entry>
80 <entry><type>Integer</type></entry>
81 <entry>0700</entry>
82 <entry>
83 Maska Umask dla haszowanej struktury katalogów.
84 </entry>
85 </row>
86 <row>
87 <entry><emphasis>file_name_prefix</emphasis></entry>
88 <entry><type>String</type></entry>
89 <entry>'zend_cache'</entry>
90 <entry>
91 przedrostek dla plików bufora ; bądź naprawdę ostrożny
92 z tą opcją, ponieważ zbyt prosta wartość w katalogu
93 systemowego bufora (jak np. /tmp) może spowodować
94 niechciane działania podczas czyszczenia bufora.
95 </entry>
96 </row>
97 <row>
98 <entry><emphasis>cache_file_umask</emphasis></entry>
99 <entry><type>Integer</type></entry>
100 <entry>0700</entry>
101 <entry>
102 maska umask dla plików bufora
103 </entry>
104 </row>
105 <row>
106 <entry><emphasis>metatadatas_array_max_size</emphasis></entry>
107 <entry><type>Integer</type></entry>
108 <entry>100</entry>
109 <entry>
110 wewnętrzny maksymalny rozmiar tablicy danych meta
111 (nie zmieniaj tej wartości jeśli nie jesteś do
112 końca pewien co robisz)
113 </entry>
114 </row>
115 </tbody>
116 </tgroup>
117 </table>
118 </sect2>
119 <sect2 id="zend.cache.backends.sqlite">
120 <title>Zend_Cache_Backend_Sqlite</title>
121 <para>
122 Ten backend przechowuje rekordy bufora w bazie SQLite.
123 </para>
124 <para>
125 Dostępne opcje to:
126 </para>
127 <table id="zend.cache.backends.sqlite.table">
128 <title>Opcje backendu Sqlite</title>
129 <tgroup cols="4">
130 <thead>
131 <row>
132 <entry>Opcja</entry>
133 <entry>Typ danych</entry>
134 <entry>Domyślna wartość</entry>
135 <entry>Opis</entry>
136 </row>
137 </thead>
138 <tbody>
139 <row>
140 <entry><emphasis>cache_db_complete_path (wymagana)</emphasis></entry>
141 <entry><type>String</type></entry>
142 <entry><constant>NULL</constant></entry>
143 <entry>
144 Kompletna ścieżka (wraz z nazwą pliku) bazy danych SQLite
145 </entry>
146 </row>
147 <row>
148 <entry><emphasis>automatic_vacuum_factor</emphasis></entry>
149 <entry><type>int</type></entry>
150 <entry>10</entry>
151 <entry>
152 Włącza / ustawia proces automatycznego czyszczenia
153 Proces automatycznego czyszczenia defragmentuje plik bazy (i zmniejsza jego rozmiar)
154 gdy wywoływane są metody clean() lub delete():
155 0 oznacza brak automatycznego czyszczenia ;
156 1 oznacza systematyczne czyszczenie (gdy wywoływane są metody delete() lub clean()) ;
157 x (integer) > 1 => automatyczne czyszczenie losow 1 raz na x wywołań clean() lub delete().
158 </entry>
159 </row>
160 </tbody>
161 </tgroup>
162 </table>
163 </sect2>
164 <sect2 id="zend.cache.backends.memcached">
165 <title>Zend_Cache_Backend_Memcached</title>
166 <para>
167 Ten backend przechowuje rekordy bufora w serwerze memcached. <ulink url="http://www.danga.com/memcached/">memcached</ulink>
168 jest systemem buforowania w pamięci rozdzielonej o wysokiej wydajności. Aby użyć tego backendu,
169 potrzebujesz działającego serwera memcached oraz <ulink url="http://pecl.php.net/package/memcache">rozszerzenia PECL memcache</ulink>.
170 </para>
171 <para>
172 Bądź odstrożny: w tym backendzie nie są obecnie obsługiwane etykiety,
173 tak samo jak argument "doNotTestCacheValidity=true".
174 </para>
175 <para>
176 Dostępne opcje to:
177 </para>
178 <table id="zend.cache.backends.memcached.table">
179 <title>Opcje backendu Memcached</title>
180 <tgroup cols="4">
181 <thead>
182 <row>
183 <entry>Opcja</entry>
184 <entry>Typ danych</entry>
185 <entry>Domyślna wartość</entry>
186 <entry>Opis</entry>
187 </row>
188 </thead>
189 <tbody>
190 <row>
191 <entry><emphasis>servers</emphasis></entry>
192 <entry><type>Array</type></entry>
193 <entry>
194 array(array('host' => 'localhost', 'port' => 11211, 'persistent' =>
195 true, 'weight' => 1, 'timeout' => 5, 'retry_interval' => 15,
196 'status' => true, 'failure_callback' => '' ))
197 </entry>
198 <entry>
199 Tablica serwerów memcached ; każdy serwer memcached jest
200 opisany przez asocjacyjną tablicę : 'host' => (string) : nazwa
201 serwera memcached, 'port' => (int) : port serwera memcached,
202 'persistent' => (bool) : używać czy nie używać stałych
203 połączeń do tego serwera memcached, 'weight' => (int) :
204 waga serwera memcached, 'timeout' => (int) : timeout
205 serwera memcached, 'retry_interval' => (int) : przerwa
206 między ponowieniami, 'status' => (bool) : status serwera
207 memcached, 'failure_callback' => (callback) : opcja
208 failure_callback serwera memcached
209 </entry>
210 </row>
211 <row>
212 <entry><emphasis>compression</emphasis></entry>
213 <entry><type>Boolean</type></entry>
214 <entry><constant>FALSE</constant></entry>
215 <entry>
216 wartość true jeśli chcesz użyć kompresji w locie
217 </entry>
218 </row>
219 <row>
220 <entry><emphasis>compatibility</emphasis></entry>
221 <entry><type>Boolean</type></entry>
222 <entry><constant>FALSE</constant></entry>
223 <entry>
224 wartość true jeśli użyć trybu zgodności
225 ze starymi serwerami/rozszerzeniami memcache
226 </entry>
227 </row>
228 </tbody>
229 </tgroup>
230 </table>
231 </sect2>
232 <sect2 id="zend.cache.backends.apc">
233 <title>Zend_Cache_Backend_Apc</title>
234 <para>
235 Ten backend przechowuje rekordy bufora we współdzielonej pamięci za
236 pomocą rozszerzenia <ulink url="http://pecl.php.net/package/APC">APC</ulink>
237 (Alternatywny bufor PHP), które oczywiście jest wymagane jeśli chcemy
238 użyć tego backendu.
239 </para>
240 <para>
241 Bądź odstrożny: w tym backendzie nie są obecnie obsługiwane etykiety,
242 tak samo jak argument "doNotTestCacheValidity=true".
243 </para>
244 <para>
245 Ten backend nie ma żadnych opcji.
246 </para>
247 </sect2>
248 <sect2 id="zend.cache.backends.xcache">
249 <title>Zend_Cache_Backend_Xcache</title>
250 <para>
251 Ten backend przechowuje rekordy buforu we współdzielonej pamięci
252 za pomocą rozszerzenia <ulink url="http://xcache.lighttpd.net/">XCache</ulink>
253 (które oczywiście jest potrzebne aby móc używać tego backendu).
254 </para>
255 <para>
256 Bądź ostrożny : ten backend obecnie nie obsługuje etykiet, podobnie jak
257 opcji "doNotTestCacheValidity=true".
258 </para>
259 <para>
260 Dostępne opcje to:
261 </para>
262 <table id="zend.cache.backends.xcache.table">
263 <title>Opcje backendu Xcache</title>
264 <tgroup cols="4">
265 <thead>
266 <row>
267 <entry>Opcja</entry>
268 <entry>Typ danych</entry>
269 <entry>Domyślna wartość</entry>
270 <entry>Opis</entry>
271 </row>
272 </thead>
273 <tbody>
274 <row>
275 <entry><emphasis>user</emphasis></entry>
276 <entry><type>string</type></entry>
277 <entry><constant>NULL</constant></entry>
278 <entry>
279 xcache.admin.user, konieczna dla metody clean()
280 </entry>
281 </row>
282 <row>
283 <entry><emphasis>password</emphasis></entry>
284 <entry><type>string</type></entry>
285 <entry><constant>NULL</constant></entry>
286 <entry>
287 xcache.admin.pass (w czystej postaci, nie MD5), koieczna dla metody clean()
288 </entry>
289 </row>
290 </tbody>
291 </tgroup>
292 </table>
293 </sect2>
294 <sect2 id="zend.cache.backends.platform">
295 <title>Zend_Cache_Backend_ZendPlatform</title>
296 <para>
297 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.
298 </para>
299 <para>
300 Ten backend obsługuje etykiety, ale nie obsługuje trybu <constant>CLEANING_MODE_NOT_MATCHING_TAG</constant> czyszczenia bufora.
301 </para>
302 <para>
303 Gdy określasz nazwę tego backendu podczas użycia metody
304 <methodname>Zend_Cache::factory()</methodname>, wstaw pomiędzy słowami 'Zend'
305 oraz 'Platform' jeden z dozwolonych separatorów wyrazów -- '-',
306 '.', ' ', lub '_':
307 </para>
308 <programlisting language="php"><![CDATA[
309 $cache = Zend_Cache::factory('Core', 'Zend Platform');
310 ]]></programlisting>
311 <para>
312 Ten backend nie ma żadnych opcji.
313 </para>
314 </sect2>
315 <sect2 id="zend.cache.backends.twolevels">
316 <title>Zend_Cache_Backend_TwoLevels</title>
317 <para>
318 Ten backend jest backendem hybrydowym. PRzechowuje on rekordu buforu
319 w dwóch innych backendach : w szybkim (ale ograniczonym) jak Apc, Memcache...
320 i w wolnym takim jak File, Sqlite...
321 </para>
322 <para>
323 Ten backend będzie wykorzystywał parametr oznaczający priorytet
324 (podany na poziomie frontendu podczas zapisywania rekordu) oraz
325 parametr oznaczający ilość miejsca do użycia przez szybki backend w
326 celu zoptymalizowania użycia tych dwóch backendów.
327 </para>
328 <para>
329 Dostępne opcje to :
330 </para>
331 <table id="zend.cache.backends.twolevels.table">
332 <title>Opcje backendu TwoLevels</title>
333 <tgroup cols="4">
334 <thead>
335 <row>
336 <entry>Opcja</entry>
337 <entry>Typ danych</entry>
338 <entry>Domyślna wartość</entry>
339 <entry>Opis</entry>
340 </row>
341 </thead>
342 <tbody>
343 <row>
344 <entry><emphasis>slow_backend</emphasis></entry>
345 <entry><type>String</type></entry>
346 <entry>File</entry>
347 <entry>
348 nazwa backendu "wolnego"
349 </entry>
350 </row>
351 <row>
352 <entry><emphasis>fast_backend</emphasis></entry>
353 <entry><type>String</type></entry>
354 <entry>Apc</entry>
355 <entry>
356 nazwa backendu "szybkiego"
357 </entry>
358 </row>
359 <row>
360 <entry><emphasis>slow_backend_options</emphasis></entry>
361 <entry><type>Array</type></entry>
362 <entry><methodname>array()</methodname></entry>
363 <entry>
364 opcje backendu "wolnego"
365 </entry>
366 </row>
367 <row>
368 <entry><emphasis>fast_backend_options</emphasis></entry>
369 <entry><type>Array</type></entry>
370 <entry><methodname>array()</methodname></entry>
371 <entry>
372 opcje backendu "szybkiego"
373 </entry>
374 </row>
375 <row>
376 <entry><emphasis>slow_backend_custom_naming</emphasis></entry>
377 <entry><type>Boolean</type></entry>
378 <entry><constant>FALSE</constant></entry>
379 <entry>
380 jeśli ma wartość true, argument slow_backend jest
381 używany jako kompletna nazwa klasy ; jeśli ma wartość
382 false, argument jest traktowany jako klasa z
383 przedrostkiem "Zend_Cache_Backend_[...]"
384 </entry>
385 </row>
386 <row>
387 <entry><emphasis>fast_backend_custom_naming</emphasis></entry>
388 <entry><type>Boolean</type></entry>
389 <entry><constant>FALSE</constant></entry>
390 <entry>
391 jeśli ma wartość true, argument fast_backend argument jest
392 używany jako kompletna nazwa klasy; jeśli ma wartość
393 false, argument jest traktowany jako klasa z
394 przedrostkiem "Zend_Cache_Backend_[...]"
395 </entry>
396 </row>
397 <row>
398 <entry><emphasis>slow_backend_autoload</emphasis></entry>
399 <entry><type>Boolean</type></entry>
400 <entry><constant>FALSE</constant></entry>
401 <entry>
402 jeśli ma wartość true, dla wolnego backendu nie
403 będzie wywoływana funkcja require_once
404 (użyteczne tylko dla własnych backendów)
405 </entry>
406 </row>
407 <row>
408 <entry><emphasis>fast_backend_autoload</emphasis></entry>
409 <entry><type>Boolean</type></entry>
410 <entry><constant>FALSE</constant></entry>
411 <entry>
412 jeśli ma wartość true, dla szybkiego backendu nie
413 będzie wywoływana funkcja require_once
414 (użyteczne tylko dla własnych backendów)
415 </entry>
416 </row>
417 <row>
418 <entry><emphasis>auto_refresh_fast_cache</emphasis></entry>
419 <entry><type>Boolean</type></entry>
420 <entry><constant>TRUE</constant></entry>
421 <entry>
422 jeśli ma wartość true, bufor z szybkiego backendu
423 zostanie automatycznie odświeżony gdy rekord bufora
424 istnieje
425 </entry>
426 </row>
427 <row>
428 <entry><emphasis>stats_update_factor</emphasis></entry>
429 <entry><type>Integer</type></entry>
430 <entry>10</entry>
431 <entry>
432 włącza / ustawia procent wypełnienia szybkiego
433 backendu (podczas zapisywania rekordu w buforze,
434 obliczenie procentu wypełnienia raz na x wywołan
435 zapisywania bufora)
436 </entry>
437 </row>
438 </tbody>
439 </tgroup>
440 </table>
441 </sect2>
442 <sect2 id="zend.cache.backends.zendserver">
443 <title>Zend_Cache_Backend_ZendServer_Disk oraz Zend_Cache_Backend_ZendServer_ShMem</title>
444 <para>
445 Te backendy przechowują rekordu bufora używając metod buforowania serwera <ulink
446 url="http://www.zend.com/en/products/server/downloads-all?zfs=zf_download">Zend
447 Server</ulink>.
448 </para>
449 <para>
450 Bądź ostrożny: te backendy nie obsługują opcji "etykiet" oraz
451 argumentu "doNotTestCacheValidity=true".
452 </para>
453 <para>
454 Te backendy działają tylko w środowisku Zend Server dla stron
455 działających w oparciu o HTTP(S) i nie działają dla skryptów konsoli.
456 </para>
457 <para>
458 Te backendy nie posiadaja opcji.
459 </para>
460 </sect2>
461 </sect1>