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

https://github.com/decaoz/zf1 · XML · 834 lines · 816 code · 16 blank · 2 comment · 0 complexity · c47dcef643edc87609ee5ea3ee6b74fc MD5 · raw file

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