[ZF-10089] Zend_Log
[zend.git] / documentation / manual / zh / module_specs / Zend_Cache-Theory.xml
blobd7761a387c2e6e4e4c0fd6933b271e2e839de971
1 <sect1 id="zend.cache.theory">
2     <title>缓存原理</title>
3     <para>
4         在Zend_Cache中有三个关键概念.一是用于标识缓存纪录的唯一标识符(一个字符串).二是<code>'lifeTime'</code>指令,正如例子中所见,
5      它定义了缓存纪录的生命期(超过该值,缓存纪录被销毁).第三个关键概念是条件执行,你的部分代码可用被跳过,以加速性能.
6         前端函数(例如. <code>Zend_Cache_Core::get()</code>)在缓存不命中时返回false,这使用户能处理<code>if(){ ... }</code>
7      语句中的条件,包含代码中他们所要缓存(或者跳过)的部分,最后是否必须保存这些你曾经生成的块(例如: <code>Zend_Cache_Core::save()</code>).
8     </para>
9     <note><para>
10        在有些前端<code>Function</code>中不需要条件执行,例如,当整个逻辑在前端内部实现的时候.
11     </para></note>
12     <note><para>
13     '缓存命中'是一个术语,它表示当一个缓存纪录发现可用,是有效的并且是'fresh'的(换言之,就是还没有过期).'Cache miss' 表示当在缓存中找不到需要的数据时,发生缓存不命中.
14         当一个Cache miss发生是,你必须生成你的数据,并使它被缓存.而对于缓存命中,后端自动透明地从Cache中取回缓存纪录.
15     </para></note>
16     <sect2 id="zend.cache.factory">
17         <title><code>Zend_Cache</code> 工厂方法 </title>
18         <para>
19             下面的示例给出了一个构造<code>Zend_Cache</code>前端实例的好方法:
20         </para>
21         <programlisting role="php"><![CDATA[
22 // We choose a backend (for example 'File' or 'Sqlite'...)
23 $backendName = '[...]';
25 // 选择一个前端(例如'Core', 'Output', 'Page'...)
26 $frontendName = '[...]';
28 // 为选择的前端设置一个选项数组
29 $frontendOptions = array([...]);
31 // 为选择的后端设置一个选项数组
32 $backendOptions = array([...]);
34 // 创建实例(当然,最后两个参数是可选的)
35 $cache = Zend_Cache::factory($frontendName, $backendName, $frontendOptions, $backendOptions);
37 ]]>
38         </programlisting>
39         <para>
40             在下面的例子中我们假设变量<code>$cache</code>保存有一个有效的,已实例化的前端,并且你知道该如何给你选择的后端传递参数.
41         </para>
42         <note><para>
43             必须使用<code>Zend_Cache::factory()</code>来得到前端实例.你自己 直接实例化的 前端或者后端 不能按照期望工作.
44         </para></note>
45     </sect2>
47     <sect2 id="zend.cache.tags">
48         <title>标记纪录</title>
49         <para>
50            标记是给缓存纪录分类的一种方法.当你使用<code>save()</code>方法保存一个缓存时,你可以给该缓存纪录设置一个或多个标记,多个标记以数组形式组织在一起
51            此后你不再需要该缓存纪录使,你可以清除所有指定标记的缓存纪录.
52         </para>
53         <programlisting role="php"><![CDATA[
54 $cache->save($huge_data, 'myUniqueID', array('tagA', 'tagB', 'tagC'));
55 ]]>
56         </programlisting>
57         <note><para>
58             note than the <code>save()</code> method accepts an optional fourth argument : <code>$specificLifetime</code>
59             (if != false, it sets a specific lifetime for this particular cache record)
60         </para></note>
61     </sect2>
62     <sect2 id="zend.cache.clean">
63         <title>缓存清理</title>
64         <para>
65             删除特定id的Cache纪录,使用<code>remove()</code>方法:
66         </para>
67         <programlisting role="php"><![CDATA[
68 $cache->remove('idToRemove');
69 ]]>
70         </programlisting>
71         <para>
72             在单个操作中删除多个Cache纪录,可以使用<code>clean()</code>方法.例如,删除所有的缓存纪录:
73         </para>
74         <programlisting role="php"><![CDATA[
75 // 清除所有缓存纪录
76 $cache->clean(Zend_Cache::CLEANING_MODE_ALL);
78 // 仅清除过期的
79 $cache->clean(Zend_Cache::CLEANING_MODE_OLD);
81 ]]>
82         </programlisting>
83         <para>
84             如果你想删除标记为'tagA'和'tagC'的缓存项:
85         </para>
86         <programlisting role="php"><![CDATA[
87 $cache->clean(Zend_Cache::CLEANING_MODE_MATCHING_TAG, array('tagA', 'tagC'));
88 ]]>
89         </programlisting>
90         <para>
91             可用的清除模式有:<code>CLEANING_MODE_ALL</code>, <code>CLEANING_MODE_OLD</code>,
92       <code>CLEANING_MODE_MATCHING_TAG</code> 和 <code>CLEANING_MODE_NOT_MATCHING_TAG</code>.
93             后面的,正如它名称所暗示的,在清除操作中组合了一个标记数组,对其中的每个元素作处理.
94         </para>
95     </sect2>
96 </sect1>
97 <!--
98 vim:se ts=4 sw=4 et:
99 -->