Zend_Cache-Backends.xml 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 20756 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.cache.backends">
  5. <title>Zend_Cache Backends</title>
  6. <para>
  7. Es gibt zwei Arten von Backends: Standard und erweiterte. Natürlich bieten erweiterte
  8. Backends mehr Features.
  9. </para>
  10. <sect2 id="zend.cache.backends.file">
  11. <title>Zend_Cache_Backend_File</title>
  12. <para>
  13. Dieses (erweiterte) Backend speichert Cache Datensätze in Dateien (in einem gewählten
  14. Verzeichnis).
  15. </para>
  16. <para>
  17. Mögliche Optionen sind :
  18. </para>
  19. <table id="zend.cache.backends.file.table">
  20. <title>File Backend Optionen</title>
  21. <tgroup cols="4">
  22. <thead>
  23. <row>
  24. <entry>Option</entry>
  25. <entry>Daten Typ</entry>
  26. <entry>Standardwert</entry>
  27. <entry>Beschreibung</entry>
  28. </row>
  29. </thead>
  30. <tbody>
  31. <row>
  32. <entry><emphasis>cache_dir</emphasis></entry>
  33. <entry><type>String</type></entry>
  34. <entry>'<filename>/tmp/</filename>'</entry>
  35. <entry>
  36. Verzeichnis, in dem die Cache Dateien gespeichert werden
  37. </entry>
  38. </row>
  39. <row>
  40. <entry><emphasis>file_locking</emphasis></entry>
  41. <entry><type>Boolean</type></entry>
  42. <entry><constant>TRUE</constant></entry>
  43. <entry>
  44. Ein- oder Ausschalten von file_locking: kann die Beschädigung des
  45. Caches unter schlechten Bedingungen verhindern, aber es hilft nicht bei
  46. Multithreaded Webservern oder bei <acronym>NFS</acronym>
  47. Filesystemen...
  48. </entry>
  49. </row>
  50. <row>
  51. <entry><emphasis>read_control</emphasis></entry>
  52. <entry><type>Boolean</type></entry>
  53. <entry><constant>TRUE</constant></entry>
  54. <entry>
  55. Ein- oder Ausschalten von read_control: eingeschaltet wird ein
  56. Kontrollschlüssel im Cache File inkludiert und dieser Schlüssel wird mit
  57. dem Schlüssel verglichen, der nach dem Lesen berechnet wird.
  58. </entry>
  59. </row>
  60. <row>
  61. <entry><emphasis>read_control_type</emphasis></entry>
  62. <entry><type>String</type></entry>
  63. <entry>'crc32'</entry>
  64. <entry>
  65. Typ der Schreibkontrolle (nur wenn read_control eingeschaltet ist).
  66. Mögliche Werte sind : 'md5' (bestes, aber am Langsamsten), 'crc32'
  67. (etwas weniger sicher, aber schneller, beste Wahl), 'adler32' (neue
  68. Wahl, schneller als crc32), 'strlen' um nur die Länge zu testen
  69. (schnellstes).
  70. </entry>
  71. </row>
  72. <row>
  73. <entry><emphasis>hashed_directory_level</emphasis></entry>
  74. <entry><type>Integer</type></entry>
  75. <entry>0</entry>
  76. <entry>
  77. Level der gehashten Verzeichnis Struktur: 0 heißt "keine gehashte
  78. Verzeichnis Strutur, 1 heißt "ein Level von Verzeichnissen", 2 heißt
  79. "zwei Levels"... Diese Option kann den Cache nur dann schneller machen,
  80. wenn viele Tausende Cache Dateien verwendet werden. Nur spezielle
  81. Messungen können helfen, den perfekten Wert zu finden. Möglicherweise
  82. ist 1 oder 2 ein guter Anfang.
  83. </entry>
  84. </row>
  85. <row>
  86. <entry><emphasis>hashed_directory_umask</emphasis></entry>
  87. <entry><type>Integer</type></entry>
  88. <entry>0700</entry>
  89. <entry>Umask für die gehashte Verzeichnis Struktur</entry>
  90. </row>
  91. <row>
  92. <entry><emphasis>file_name_prefix</emphasis></entry>
  93. <entry><type>String</type></entry>
  94. <entry>'zend_cache'</entry>
  95. <entry>
  96. Präfix für Cache Dateien; man muss mit dieser Option sehr vorsichtig
  97. umgehen, weil ein zu generischer Wert in einem System Cache
  98. Verzeichnis (wie <filename>/tmp</filename>) kann beim Löschen des
  99. Caches zu großen Problemen führen.
  100. </entry>
  101. </row>
  102. <row>
  103. <entry><emphasis>cache_file_umask</emphasis></entry>
  104. <entry><type>Integer</type></entry>
  105. <entry>0700</entry>
  106. <entry>umask nach Cache Dateien</entry>
  107. </row>
  108. <row>
  109. <entry><emphasis>metatadatas_array_max_size</emphasis></entry>
  110. <entry><type>Integer</type></entry>
  111. <entry>100</entry>
  112. <entry>
  113. Interne maximale Größe für das Metadaten Array (dieser Wert sollte
  114. nicht geändert werden außer man weiß was man macht)
  115. </entry>
  116. </row>
  117. </tbody>
  118. </tgroup>
  119. </table>
  120. </sect2>
  121. <sect2 id="zend.cache.backends.sqlite">
  122. <title>Zend_Cache_Backend_Sqlite</title>
  123. <para>
  124. Dieses (erweiterte) Backend speichert die Cache Datensätze in einer SQLite Datenbank.
  125. </para>
  126. <para>
  127. Mögliche Optionen sind :
  128. </para>
  129. <table id="zend.cache.backends.sqlite.table">
  130. <title>Sqlite Backend Optionen</title>
  131. <tgroup cols="4">
  132. <thead>
  133. <row>
  134. <entry>Option</entry>
  135. <entry>Daten Typ</entry>
  136. <entry>Standardwert</entry>
  137. <entry>Beschreibung</entry>
  138. </row>
  139. </thead>
  140. <tbody>
  141. <row>
  142. <entry><emphasis>cache_db_complete_path (mandatory)</emphasis></entry>
  143. <entry><type>String</type></entry>
  144. <entry><constant>NULL</constant></entry>
  145. <entry>
  146. Der komplette Pfad (inklusive Dateiname) der SQLite Datenbank
  147. </entry>
  148. </row>
  149. <row>
  150. <entry><emphasis>automatic_vacuum_factor</emphasis></entry>
  151. <entry><type>Integer</type></entry>
  152. <entry>10</entry>
  153. <entry>
  154. Deaktiviert oder stellt den automatischen Vakuumprozess ein.
  155. Der automatische Vakuumprozess defragmentiert die Datenbankdatei (und
  156. verkleinert sie) wenn <methodname>clean()</methodname> oder
  157. <methodname>delete()</methodname> aufgerufen wird: 0 bedeutet kein
  158. automatisches Vakuum; 1 bedeutet systematisches Vakuum (wenn die
  159. <methodname>delete()</methodname> or <methodname>clean()</methodname>
  160. Methoden aufgerufen werden; x (integer) > 1 => automatisches Vakuum
  161. zufällig einmal pro x <methodname>clean()</methodname> oder
  162. <methodname>delete()</methodname> Aufrufe.
  163. </entry>
  164. </row>
  165. </tbody>
  166. </tgroup>
  167. </table>
  168. </sect2>
  169. <sect2 id="zend.cache.backends.memcached">
  170. <title>Zend_Cache_Backend_Memcached</title>
  171. <para>
  172. Dieses (erweiterte) Backend speichert Cache Datensätze in einem Memcached Server. <ulink
  173. url="http://www.danga.com/memcached/">memcached</ulink> ist ein hoch-performantes,
  174. verteiltes Speicher Objekt Caching System. Um dieses Backend zu benutzen, wird ein
  175. Memcached Dämon benötigt und <ulink url="http://pecl.php.net/package/memcache">die
  176. Memcached <acronym>PECL</acronym> Erweiterung</ulink>.
  177. </para>
  178. <para>
  179. Vorsicht: mit diesem Backend werden zur Zeit "Marker" nicht unterstützt genauso wie das
  180. "doNotTestCacheValidity=true" Argument.
  181. </para>
  182. <para>
  183. Mögliche Optionen sind :
  184. </para>
  185. <table id="zend.cache.backends.memcached.table">
  186. <title>Memcached Backend Optionen</title>
  187. <tgroup cols="4">
  188. <thead>
  189. <row>
  190. <entry>Option</entry>
  191. <entry>Daten Typ</entry>
  192. <entry>Standardwert</entry>
  193. <entry>Beschreibung</entry>
  194. </row>
  195. </thead>
  196. <tbody>
  197. <row>
  198. <entry><emphasis>servers</emphasis></entry>
  199. <entry><type>Array</type></entry>
  200. <entry>
  201. <command>array(array('host' => 'localhost','port' => 11211,
  202. 'persistent' => true, 'weight' => 1, 'timeout' => 5,
  203. 'retry_interval' => 15, 'status' => true,
  204. 'failure_callback' => '' ))</command>
  205. </entry>
  206. <entry>
  207. Ein Array von Memcached Servern; jeder Memcached Server wird durch ein
  208. assoziatives Array beschrieben : 'host' => (string) : Der Name des
  209. Memcached Servers, 'port' => (int) : Der Port des Memcached Servers,
  210. 'persistent' => (bool) : Persistente Verbindungen für diesen Memcached
  211. Server verwenden oder nicht 'weight' => (int) : Das Gewicht des
  212. Memcached Servers, 'timeout' => (int) : Das Timeout des Memcached
  213. Servers, 'retry_interval' => (int) : Das Wiederholungsintervall des
  214. Memcached Servers, 'status' => (bool) : Der Status des Memcached
  215. Servers, 'failure_callback' => (callback) : Der failure_callback des
  216. Memcached Servers
  217. </entry>
  218. </row>
  219. <row>
  220. <entry><emphasis>compression</emphasis></entry>
  221. <entry><type>Boolean</type></entry>
  222. <entry><constant>FALSE</constant></entry>
  223. <entry>
  224. <constant>TRUE</constant> wenn on-the-fly Kompression verwendet werden
  225. soll
  226. </entry>
  227. </row>
  228. <row>
  229. <entry><emphasis>compatibility</emphasis></entry>
  230. <entry><type>Boolean</type></entry>
  231. <entry><constant>FALSE</constant></entry>
  232. <entry>
  233. <constant>TRUE</constant> wenn man den Compatibility Modus mit alten
  234. Memcache Servern oder Erweiterungen verwenden will
  235. </entry>
  236. </row>
  237. </tbody>
  238. </tgroup>
  239. </table>
  240. </sect2>
  241. <sect2 id="zend.cache.backends.apc">
  242. <title>Zend_Cache_Backend_Apc</title>
  243. <para>
  244. Dieses (erweiterte) Backend speichert Cache Datensätze im Shared Memory durch die
  245. <ulink url="http://pecl.php.net/package/APC">APC</ulink> (Alternativer
  246. <acronym>PHP</acronym> Cache) Erweiterung (welche natürlich für die Verwendung dieses
  247. Backends benötigt wird).
  248. </para>
  249. <para>
  250. Vorsicht: mit diesem Backend werden "Marker" zur Zeit nicht unterstützt genauso wie das
  251. "doNotTestCacheValidity=true" Argument.
  252. </para>
  253. <para>
  254. Es gibt keine Optionen für dieses Backend.
  255. </para>
  256. </sect2>
  257. <sect2 id="zend.cache.backends.xcache">
  258. <title>Zend_Cache_Backend_Xcache</title>
  259. <para>
  260. Dieses Backend speichert Cache Einträge im Shared Memory durch die
  261. <ulink url="http://xcache.lighttpd.net/">XCache</ulink> Erweiterung (welche natürlich
  262. benötigt wird, damit dieses Backend verwendet werden kann).
  263. </para>
  264. <para>
  265. Achtung: Bei diesem Backend werden "tags" aktuell nicht unterstützt sowie das
  266. "doNotTestCacheValidity=true" Argument.
  267. </para>
  268. <para>
  269. Mögliche Optionen sind:
  270. </para>
  271. <table id="zend.cache.backends.xcache.table">
  272. <title>Xcache backend options</title>
  273. <tgroup cols="4">
  274. <thead>
  275. <row>
  276. <entry>Option</entry>
  277. <entry>Daten Typ</entry>
  278. <entry>Standardwert</entry>
  279. <entry>Beschreibung</entry>
  280. </row>
  281. </thead>
  282. <tbody>
  283. <row>
  284. <entry><emphasis>user</emphasis></entry>
  285. <entry><type>String</type></entry>
  286. <entry><constant>NULL</constant></entry>
  287. <entry>
  288. <filename>xcache.admin.user</filename>, notwendig für die
  289. <methodname>clean()</methodname> Methode
  290. </entry>
  291. </row>
  292. <row>
  293. <entry><emphasis>password</emphasis></entry>
  294. <entry><type>String</type></entry>
  295. <entry><constant>NULL</constant></entry>
  296. <entry>
  297. <filename>xcache.admin.pass</filename> (in offener Form, nicht
  298. <acronym>MD5</acronym>), notwendig für die
  299. <methodname>clean()</methodname> Methode
  300. </entry>
  301. </row>
  302. </tbody>
  303. </tgroup>
  304. </table>
  305. </sect2>
  306. <sect2 id="zend.cache.backends.platform">
  307. <title>Zend_Cache_Backend_ZendPlatform</title>
  308. <para>
  309. Dieses Backend verwendet die Content Caching <acronym>API</acronym> des
  310. <ulink url="http://www.zend.com/en/products/platform">Zend Platform</ulink> Produktes.
  311. Natürlich muss man die Zend Platform installiert haben, um dieses Backend verwenden zu
  312. können.
  313. </para>
  314. <para>
  315. Dieses Backend unterstützt Tags, aber nicht den
  316. <constant>CLEANING_MODE_NOT_MATCHING_TAG</constant> Löschmodus.
  317. </para>
  318. <para>
  319. Bei Definition dieses Backends muß ein Trennzeichen -- '-', '.', ' ', oder '_'
  320. -- zwischen den Wörtern 'Zend' und 'Platform' definiert sein wenn die
  321. <methodname>Zend_Cache::factory()</methodname> Methode verwendet wird:
  322. </para>
  323. <programlisting language="php"><![CDATA[
  324. $cache = Zend_Cache::factory('Core', 'Zend Platform');
  325. ]]></programlisting>
  326. <para>
  327. Es gibt keine Optionen für dieses Backend.
  328. </para>
  329. </sect2>
  330. <sect2 id="zend.cache.backends.twolevels">
  331. <title>Zend_Cache_Backend_TwoLevels</title>
  332. <para>
  333. Dieses (erweiterte) Backend ist ein Hybrides. Es speichert Cache Einträge in zwei
  334. anderen Backends: Ein schnelles (aber limitiertes) wie Apc, Memcache... und ein
  335. "langsames" wie File, Sqlite...
  336. </para>
  337. <para>
  338. Dieses Backend verwendet den Priority Parameter (der auf Frontend Level angegeben wird
  339. wenn ein Eintrag gespeichert wird) und den verbleibenden Platz im schnellen Backend um
  340. die Verwendung dieser zwei Backends zu optimieren.
  341. </para>
  342. <para>
  343. Dieses Backend sollte mit Verwendung eines Word Separators -- '-', '.', ' ', oder '_' --
  344. zwischen den Wörtern 'Two' und 'Levels' spezifiziert werden wenn die
  345. <methodname>Zend_Cache::factory()</methodname> Methode verwendet wird:
  346. </para>
  347. <programlisting language="php"><![CDATA[
  348. $cache = Zend_Cache::factory('Core', 'Two Levels');
  349. ]]></programlisting>
  350. <para>
  351. Vorhandene Optionen sind:
  352. </para>
  353. <table id="zend.cache.backends.twolevels.table">
  354. <title>TwoLevels Backend Optionen</title>
  355. <tgroup cols="4">
  356. <thead>
  357. <row>
  358. <entry>Option</entry>
  359. <entry>Datentyp</entry>
  360. <entry>Standardwert</entry>
  361. <entry>Beschreibung</entry>
  362. </row>
  363. </thead>
  364. <tbody>
  365. <row>
  366. <entry><emphasis>slow_backend</emphasis></entry>
  367. <entry><type>String</type></entry>
  368. <entry>File</entry>
  369. <entry>Der "langsame" Backendname</entry>
  370. </row>
  371. <row>
  372. <entry><emphasis>fast_backend</emphasis></entry>
  373. <entry><type>String</type></entry>
  374. <entry>Apc</entry>
  375. <entry>Der "schnelle" Backendname</entry>
  376. </row>
  377. <row>
  378. <entry><emphasis>slow_backend_options</emphasis></entry>
  379. <entry><type>Array</type></entry>
  380. <entry><methodname>array()</methodname></entry>
  381. <entry>Die "langsamen" Backendoptionen</entry>
  382. </row>
  383. <row>
  384. <entry><emphasis>fast_backend_options</emphasis></entry>
  385. <entry><type>Array</type></entry>
  386. <entry><methodname>array()</methodname></entry>
  387. <entry>Die "schnellen" Backendoptionen</entry>
  388. </row>
  389. <row>
  390. <entry><emphasis>slow_backend_custom_naming</emphasis></entry>
  391. <entry><type>Boolean</type></entry>
  392. <entry><constant>FALSE</constant></entry>
  393. <entry>
  394. Wenn <constant>TRUE</constant>, wird das slow_backend Argument als
  395. kompletter Klassenname verwendet; wenn <constant>FALSE</constant>,
  396. wird das frontend Argument als Ende des
  397. "<classname>Zend_Cache_Backend_</classname>[...]" Klassennamens
  398. verwendet
  399. </entry>
  400. </row>
  401. <row>
  402. <entry><emphasis>fast_backend_custom_naming</emphasis></entry>
  403. <entry><type>Boolean</type></entry>
  404. <entry><constant>FALSE</constant></entry>
  405. <entry>
  406. Wenn <constant>TRUE</constant>, wird das fast_backend Argument als
  407. kompletter Klassenname verwendet; wenn <constant>FALSE</constant>,
  408. wird das frontend Argument als Ende des
  409. "<classname>Zend_Cache_Backend_</classname>[...]" Klassennamens
  410. verwendet
  411. </entry>
  412. </row>
  413. <row>
  414. <entry><emphasis>slow_backend_autoload</emphasis></entry>
  415. <entry><type>Boolean</type></entry>
  416. <entry><constant>FALSE</constant></entry>
  417. <entry>
  418. Wenn <constant>TRUE</constant>, wird kein require_once für das
  419. langsame Backend verwendet (nur für eigene Backends nützlich)
  420. </entry>
  421. </row>
  422. <row>
  423. <entry><emphasis>fast_backend_autoload</emphasis></entry>
  424. <entry><type>Boolean</type></entry>
  425. <entry><constant>FALSE</constant></entry>
  426. <entry>
  427. Wenn <constant>TRUE</constant>, wird kein require_once für das
  428. schnelle Backend verwendet (nur für eigene Backends nützlich)
  429. </entry>
  430. </row>
  431. <row>
  432. <entry><emphasis>auto_refresh_fast_cache</emphasis></entry>
  433. <entry><type>Boolean</type></entry>
  434. <entry><constant>TRUE</constant></entry>
  435. <entry>
  436. Wenn <constant>TRUE</constant>, wird der schnelle Cache automatisch
  437. refresht wenn ein Cache Eintrag getroffen wird
  438. </entry>
  439. </row>
  440. <row>
  441. <entry><emphasis>stats_update_factor</emphasis></entry>
  442. <entry><type>Integer</type></entry>
  443. <entry>10</entry>
  444. <entry>
  445. Ausschalten / Feintunen der Berechnung des Füll-Prozentsatzes des
  446. schnellen Backends (wenn ein Eintrag in den Cache gespeichert wird,
  447. die Berechnung des Füll-Prozentsatzes des schnellen Backends zufällig
  448. 1 mal bei x Cache Schreibvorgängen)
  449. </entry>
  450. </row>
  451. </tbody>
  452. </tgroup>
  453. </table>
  454. </sect2>
  455. <sect2 id="zend.cache.backends.zendserver">
  456. <title>Zend_Cache_Backend_ZendServer_Disk und Zend_Cache_Backend_ZendServer_ShMem</title>
  457. <para>
  458. Diese Backends speichern Cacheeinträge indem Sie die Caching Funktionalitäten von <ulink
  459. url="http://www.zend.com/en/products/server/downloads-all?zfs=zf_download">Zend
  460. Server</ulink> verwenden.
  461. </para>
  462. <para>
  463. Achtung: mit diesen Backends werden für den Moment "Tags" nicht unterstützt, wegen dem
  464. "doNotTestCacheValidity=true" Argument.
  465. </para>
  466. <para>
  467. Diese Backends arbeiten nur in einer Zend Server Umgebung für Seiten die über
  468. <acronym>HTTP</acronym> oder <acronym>HTTPS</acronym> angefragt wurden und nicht für
  469. Kommandozeilen Ausführung.
  470. </para>
  471. <para>
  472. Dieses Backend muß durch Verwendung des <emphasis>customBackendNaming</emphasis>
  473. Parameter mit <constant>TRUE</constant> spezifiziert werden wenn die Methode
  474. <methodname>Zend_Cache::factory()</methodname> verwendet wird:
  475. </para>
  476. <programlisting language="php"><![CDATA[
  477. $cache = Zend_Cache::factory('Core', 'Zend_Cache_Backend_ZendServer_Disk',
  478. $frontendOptions, $backendOptions, false, true);
  479. ]]></programlisting>
  480. <para>
  481. Es gibt keine Optionen für diese Backends.
  482. </para>
  483. </sect2>
  484. <sect2 id="zend.cache.backends.static">
  485. <title>Zend_Cache_Backend_Static</title>
  486. <para>
  487. Dieses Backend arbeitet in Verbindung mit
  488. <classname>Zend_Cache_Frontend_Capture</classname> (diese zwei müssen zusammen verwendet
  489. werden) um die Ausgabe von Anfragen als statische Dateien zu speichern. Dies bedeutet
  490. das die statischen Dateien bei weiteren Anfragen direkt serviert werden ohne das PHP
  491. oder sogar der Zend Framework involviert sind.
  492. </para>
  493. <para>
  494. Der Vorteil dieses Caches besteht darin das eine starke Verbesserung des Durchsatzes
  495. stattfindet weil statische Dateien zurückgegeben werden und keine weitere dynamische
  496. Bearbeitung stattfindet. Natürlich gibt es auch einige Nachteile. Der einzige Weg um
  497. dynamische Anfragen wieder zu haben besteht darin die gecachten Dateien von anderswo
  498. in der Anwendung zu löschen (oder über einen Cronjob wenn das zeitlich abgestimmt werden
  499. soll). Es ist auch auf Single-Server Anwendungen begrenzt begrenzt bei denen nur ein
  500. Dateisystem verwendet wird. Trotzdem kann es eine große Bedeutung haben wenn man mehr
  501. Geschwindigkeit haben will ohne auf Kosten eines Proxies auf einzelnen Maschinen zu
  502. setzen.
  503. </para>
  504. <para>
  505. Bevor die Optionen beschrieben werden sollte man beachten das dies einige Änderungen der
  506. Standardwerte in der .htaccess Datei benötigt damit Anfrage auf die staischen Dateien
  507. zeigen wenn diese existieren. Hier ist ein Beispiel einer einfachen Anwendung die etwas
  508. Inhalt cacht, inklusive zwei spezifischer Feeds welche zusätzliche Behandlung benötigen
  509. um einen korrekten Content-Type Header zu schicken:
  510. </para>
  511. <programlisting language="text"><![CDATA[
  512. AddType application/rss+xml .xml
  513. AddType application/atom+xml .xml
  514. RewriteEngine On
  515. RewriteCond %{REQUEST_URI} feed/rss$
  516. RewriteCond %{DOCUMENT_ROOT}/cached/%{REQUEST_URI}.xml -f
  517. RewriteRule .* cached/%{REQUEST_URI}.xml [L,T=application/rss+xml]
  518. RewriteCond %{REQUEST_URI} feed/atom$
  519. RewriteCond %{DOCUMENT_ROOT}/cached/%{REQUEST_URI}.xml -f
  520. RewriteRule .* cached/%{REQUEST_URI}.xml [L,T=application/atom+xml]
  521. RewriteCond %{DOCUMENT_ROOT}/cached/index.html -f
  522. RewriteRule ^/*$ cached/index.html [L]
  523. RewriteCond %{DOCUMENT_ROOT}/cached/%{REQUEST_URI}.(html|xml|json|opml|svg) -f
  524. RewriteRule .* cached/%{REQUEST_URI}.%1 [L]
  525. RewriteCond %{REQUEST_FILENAME} -s [OR]
  526. RewriteCond %{REQUEST_FILENAME} -l [OR]
  527. RewriteCond %{REQUEST_FILENAME} -d
  528. RewriteRule ^.*$ - [NC,L]
  529. RewriteRule ^.*$ index.php [NC,L]
  530. ]]></programlisting>
  531. <para>
  532. Das obenstehende nimmt an das statische Dateien im Verzeichnis ./public/cached gecacht
  533. werden. Wir betrachten die Einstellung dieses Ortes unter "public_dir" weiter unten.
  534. </para>
  535. <para>
  536. Durch die Natur des Cachens von statischen Dateien bietet die Backend Klasse zwei
  537. zusätzliche Methoden an: <methodname>remove()</methodname> und
  538. <methodname>removeRecursively()</methodname>. Beide akzeptieren eine Anfrage URI
  539. welche, wenn Sie mit dem "public_dir" in dem statische Dateien gecacht werden verknüpft
  540. wird, und eine vor-gespeicherte Erweiterung angehängt wird, entweder den Namen einer
  541. statischen Datei anbietet welche zu löschen ist, oder einen Verzeichnispfad welcher
  542. rekursiv zu löschen ist. Durch die Einschränkung von
  543. <classname>Zend_Cache_Backend_Interface</classname> akzeptieren alle anderen Methoden
  544. wie <classname>save()</classname> eine ID welche durch Anwendung von bin2hex() auf eine
  545. Anfrage URI berechnet wird.
  546. </para>
  547. <para>
  548. Durch das Level an dem das statische Cachen arbeitet ist das statische Dateicaching
  549. auf eine einfachere Verwendung mit
  550. <classname>Zend_Controller_Action_Helper_Cache</classname> ausgelegt. Dieser Helfer
  551. assistiert beim Einstellen welche Aktionen eines Controllers zu cachen sind, mit welchen
  552. Tags, und mit welcher Erweiterung. Er bietet auch Methoden für das Entleeren des Caches
  553. durch die Anfrage URI oder Tag. Statischen Dateicaching wird auch durch
  554. <classname>Zend_Cache_Manager</classname> unterstützt welcher vorkonfigurierte
  555. Konfigurationstemplates für den statischen Cache enthält (als
  556. Zend_Cache_Manager::PAGECACHE oder "page"). Die Standardwerte können hierbei wie
  557. benötigt konfiguriert werden um einen "public_dir" Ort für das Cachen zu setzen, usw.
  558. </para>
  559. <note>
  560. <para>
  561. Es sollte beachtet werden dass der statische Cache aktuell einen zweiten Cache
  562. verwendet um Tags zu speichern (offensichtlich können wir Sie nicht anderswo
  563. speichern da bei einem statischen Cache PHP nicht aufgerufen wird wenn er
  564. richtig arbeitet). Das ist nur ein standardmäßiger Core Cache, und er sollte ein
  565. persistentes Backend wie File oder TwoLevels verwenden (um die Vorteile des
  566. Memory Speichers zu verwenden ohne die permanente Persistenz zu opfern). Das
  567. Backend enthält die Option "tag_cache" um es zu konfigurieren (das ist
  568. obligatorisch), oder die Methode <methodname>setInnerCache()</methodname>.
  569. </para>
  570. </note>
  571. <table id="zend.cache.backends.static.table">
  572. <title>Statische Backend Optionen</title>
  573. <tgroup cols="4">
  574. <thead>
  575. <row>
  576. <entry>Option</entry>
  577. <entry>Datentyp</entry>
  578. <entry>Standardwert</entry>
  579. <entry>Beschreibung</entry>
  580. </row>
  581. </thead>
  582. <tbody>
  583. <row>
  584. <entry><emphasis>public_dir</emphasis></entry>
  585. <entry><type>String</type></entry>
  586. <entry>NULL</entry>
  587. <entry>
  588. Verzeichnis in dem statische Dateien zu speichern sind. Es muß im
  589. öffentlichen Verzeichnis existieren.
  590. </entry>
  591. </row>
  592. <row>
  593. <entry><emphasis>file_locking</emphasis></entry>
  594. <entry><type>Boolean</type></entry>
  595. <entry><constant>TRUE</constant></entry>
  596. <entry>
  597. file_locking aktivieren oder deaktivieren: Kann die Korruption des
  598. Caches unter schlechten Umständen verhindern hilft aber nicht bei
  599. Multithreaded Webservern oder bei <acronym>NFS</acronym> Dateisystemen.
  600. </entry>
  601. </row>
  602. <row>
  603. <entry><emphasis>read_control</emphasis></entry>
  604. <entry><type>Boolean</type></entry>
  605. <entry><constant>TRUE</constant></entry>
  606. <entry>
  607. Lesekontrolle aktivieren oder deaktivieren: Aktiviert wird ein
  608. Kontrollschlüssel in die Cachedatei eingebettet und dieser Schlüssel
  609. wird mit dem verglichen der nach dem Lesen berechnet wird.
  610. </entry>
  611. </row>
  612. <row>
  613. <entry><emphasis>read_control_type</emphasis></entry>
  614. <entry><type>String</type></entry>
  615. <entry>'crc32'</entry>
  616. <entry>
  617. Typ der Lesekontrolle (nur wenn die Lesekontrolle aktiviert ist).
  618. Mögliche Werte sind: 'md5' (am besten aber langsam), 'crc32' (etwas
  619. weniger sicher aber schneller, bessere Wahl), 'adler32' (neue Wahl,
  620. schneller als cec32), 'strlen' für einen reinen Längentest (am
  621. schnellsten).
  622. </entry>
  623. </row>
  624. <row>
  625. <entry><emphasis>cache_file_umask</emphasis></entry>
  626. <entry><type>Integer</type></entry>
  627. <entry>0700</entry>
  628. <entry>Umask für gecachte Dateien.</entry>
  629. </row>
  630. <row>
  631. <entry><emphasis>cache_directory_umask</emphasis></entry>
  632. <entry><type>Integer</type></entry>
  633. <entry>0700</entry>
  634. <entry>Umask für Verzeichnisse welche im public_dir erstellt wurden.</entry>
  635. </row>
  636. <row>
  637. <entry><emphasis>file_extension</emphasis></entry>
  638. <entry><type>String</type></entry>
  639. <entry>'.html'</entry>
  640. <entry>
  641. Standardmäßige Dateierweiterung für erstellt statische Dateien. Diese
  642. kann im Fluge konfiguriert werden, siehe
  643. <methodname>Zend_Cache_Backend_Static::save()</methodname> obwohl
  644. generell empfohlen wird sich auf
  645. <classname>Zend_Controller_Action_Helper_Cache</classname> zu verlassen
  646. wenn man das macht, weil es ein einfacherer Weg ist als mit Arrays und
  647. der manuellen Serialisierung herumzuspielen.
  648. </entry>
  649. </row>
  650. <row>
  651. <entry><emphasis>index_filename</emphasis></entry>
  652. <entry><type>String</type></entry>
  653. <entry>'index'</entry>
  654. <entry>
  655. Wenn eine Anfrage URI nicht genügend Informationen enthält um eine
  656. statische Datei zu erstellen (normalerweise bedeutet dies einen
  657. Indexaufruf, z.B. die URI von '/'), dann wir stattdessen
  658. index_filename verwendet. Deshalb würden '' oder '/' auf 'index.html'
  659. verweisen (in der Annahme das die standardmäßige file_extension '.html'
  660. ist).
  661. </entry>
  662. </row>
  663. <row>
  664. <entry><emphasis>tag_cache</emphasis></entry>
  665. <entry><type>Object</type></entry>
  666. <entry>NULL</entry>
  667. <entry>
  668. Wird verwendet um einen 'inner' Cache zu Setzen der verwendet wird um
  669. Tags zu speichern und Dateierweiterungen mit statischen Dateien zu
  670. verknüpfen. Das MUSS gesetzt sein, oder der statische Cache kann nicht
  671. verfolgt und gemanagt werden.
  672. </entry>
  673. </row>
  674. <row>
  675. <entry><emphasis>disable_caching</emphasis></entry>
  676. <entry><type>Boolean</type></entry>
  677. <entry>FALSE</entry>
  678. <entry>
  679. Wenn es auf TRUE gesetzt wird, werden statische Dateien nicht gecacht.
  680. Das zwingt alle Anfragen dynamisch zu sein, selbst wenn diese markiert
  681. und in den Controller gecacht sind. Dies ist für das Debuggen nützlich.
  682. </entry>
  683. </row>
  684. </tbody>
  685. </tgroup>
  686. </table>
  687. </sect2>
  688. </sect1>