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

  1<sect1 id="zend.cache.backends">
  2    <title>Zend_Cache backends</title>
  3
  4    <sect2 id="zend.cache.backends.file">
  5        <title>Zend_Cache_Backend_File</title>
  6        <para>
  7            هذا الـ backend يقوم بحفظ الـ cache records فى ملفات (داخل مجلد يتم تحديده).
  8        </para>
  9        <para>
 10           الـ options المتوفرة
 11        </para>
 12        <table>
 13            <title>الـ options المتوفرة لـ Zend_Cache_Backend_File</title>
 14            <tgroup cols="4">
 15                 <thead>
 16                      <row>
 17                        <entry>الـ Option</entry>
 18                        <entry>الـ Data Type</entry>
 19                        <entry>الـ Default Value</entry>
 20                        <entry>الوصف</entry>
 21                    </row>
 22                 </thead>
 23                 <tbody>
 24                      <row>
 25                          <entry><code>cacheDir</code></entry>
 26                          <entry><code>string</code></entry>
 27                          <entry><code>'/tmp/'</code></entry>
 28                          <entry>
 29                              المجلد حيث سيتم حفظ ملفات الـ cache
 30                          </entry>
 31                      </row>
 32                      <row>
 33                          <entry><code>fileLocking</code></entry>
 34                          <entry><code>boolean</code></entry>
 35                          <entry><code>true</code></entry>
 36                          <entry>
 37                           تفعيل او إيقاف خاصية الـ fileLocking : تساعد فى تجنب تلف ملفات الـ cache
 38                            و لكن لا تساعد عند العمل على multithread webservers او نظام ملفات NFS...
 39                          </entry>
 40                      </row>
 41                      <row>
 42                          <entry><code>readControl</code></entry>
 43                          <entry><code>boolean</code></entry>
 44                          <entry><code>true</code></entry>
 45                          <entry>
 46                            تقوم بتفعيل او ايقاف الـ read control :
 47                            إن تم تشغيله, سيتم اضافة control key فى ملف الـ cache و هذا الـ key "مفتاح"
 48                            سيتم مقارنته مع الأخر الذى سيتم حسابه بعد قرائة الملف.
 49                          </entry>
 50                      </row>
 51                      <row>
 52                          <entry><code>readControlType</code></entry>
 53                          <entry><code>string</code></entry>
 54                          <entry><code>'crc32'</code></entry>
 55                          <entry>
 56                            نوع الـ read control (متوفر فقط إذا كانت read control مفعلة).
 57                            القيم المتوفرة هى :
 58                            "md5" الأفضل لكن الأبطء, "crc32" (اقل امانا لكن اسرع, الأختيار الأفضل),
 59                            "strlen" لعمل اختبار طول فقط (الأسرع).
 60                        </entry>
 61                      </row>
 62                      <row>
 63                          <entry><code>hashedDirectoryLevel</code></entry>
 64                          <entry><code>int</code></entry>
 65                          <entry><code>0</code></entry>
 66                          <entry>
 67                            Hashed directory structure level :     0 تعنى "no hashed directory
 68                             structure", 1 تعنى "one level of directory", 2 تعنى "two levels"...
 69                             هذا الـ option يمكن ان يرفع من سرعة اداء عملية الـ cache و ذلك فقط إن كنت تعمل مع
 70                            الاف من ملفات الـ cache. ربما بعض القياسات ستساعدك فى تحديد افضل قيمة مناسبة لك.
 71                            ربما 1 او 2 تعتبر بداية جيدة.
 72                          </entry>
 73                      </row>
 74                      <row>
 75                          <entry><code>hashedDirectoryUmask</code></entry>
 76                          <entry><code>int</code></entry>
 77                          <entry><code>0700</code></entry>
 78                          <entry>
 79                              Umask للـ hashed directory structure
 80                        </entry>
 81                      </row>
 82                  </tbody>
 83              </tgroup>
 84          </table>
 85    </sect2>
 86    <sect2 id="zend.cache.backends.sqlite">
 87        <title>Zend_Cache_Backend_Sqlite</title>
 88        <para>
 89            هذه الـ backend تقوم بحفظ الـ cache records فى قاعدة بيانات SQLite.
 90        </para>
 91        <para>
 92            الـ options المتوفرة:
 93        </para>
 94        <table>
 95            <title>الـ options المتوفرة لـ Zend_Cache_Backend_Sqlite</title>
 96            <tgroup cols="4">
 97                 <thead>
 98                      <row>
 99                           <entry>الـ Option</entry>
100                        <entry>الـ Data Type</entry>
101                        <entry>الـ Default Value</entry>
102                        <entry>الوصف</entry>
103                    </row>
104                 </thead>
105                 <tbody>
106                      <row>
107                          <entry><code>cacheDBCompletePath (mandatory)</code></entry>
108                          <entry><code>string</code></entry>
109                          <entry><code>null</code></entry>
110                          <entry>
111                              المسار الكامل (مع اسم الملف) التى توجد به قاعدة بيانات SQLite.
112                          </entry>
113                      </row>
114                        <row>
115                          <entry><code>automaticVacuumFactor</code></entry>
116                          <entry><code>int</code></entry>
117                          <entry><code>10</code></entry>
118                          <entry>
119                            تقوم بـ إيقاف / إدارة عملية تنظيم الفراغات التلقائية.
120                            عملية تنظيم الفراغات التلقائية تقوم بعمل defragment لملف قاعدة البيانات
121                            (و تجعله أصغر) عند إستدعاء ()clean أو ()delete :
122                            و 0 تعنى إيقاف عملية تنظيم الفراغات التلقائية ;
123                            1 تعنى تشغيل عملية الإدارة (عند إستدعاء ()delete أو ()clean ) ;
124                            x (integer) > 1  => ستتم عملية تنظيم الفراغات عشوائياً مرة لكل
125                            x مرة من إستدعاء ()clean أو ()delete .
126                          </entry>
127                        </row>
128                  </tbody>
129              </tgroup>
130          </table>
131    </sect2>
132    <sect2 id="zend.cache.backends.memcached">
133        <title>Zend_Cache_Backend_Memcached</title>
134        <para>
135           هذه الـ backend تقوم بحفظ الـ cache records فى memcached server.
136<ulink url="http://www.danga.com/memcached/">memcached</ulink>
137عبارة عن نظام caching للبيانات فى الذاكرة و يتميز بكفائته العالية.
138لتستخدم هذا الـ backend انت تحتاج memcached daemon و
139<ulink url="http://pecl.php.net/package/memcache">الـ memcache PECL extension</ulink>.
140        </para>
141        <para>
142            احترس: مع هذا الـ backend الـ tags غير مدعومة الى الأن .
143(لأن "doNotTestCacheValidity=true")
144        </para>
145        <para>
146             الـ options المتوفرة :
147        </para>
148        <table>
149            <title> الـ options المتوفرة لـ Zend_Cache_Backend_Memcached</title>
150            <tgroup cols="4">
151                 <thead>
152                      <row>
153                        <entry>الـ Option</entry>
154                        <entry>الـ Data Type</entry>
155                        <entry>الـ Default Value</entry>
156                        <entry>الوصف</entry>
157                    </row>
158                 </thead>
159                 <tbody>
160                      <row>
161                          <entry><code>servers</code></entry>
162                          <entry><code>array</code></entry>
163                          <entry><code>array(array('host' => 'localhost','port' => 11211, 'persistent' => true))</code></entry>
164                          <entry>
165                              An array of memcached servers ; each memcached server is described by an associative array :
166                              'host' => (string) : اسم الـ memcached server,
167                              'port' => (int) : الـ port الخاص بالـ memcached server,
168                              'persistent' => (bool) : استخدام او عدم استخدام الـ persistant connections مع هذا الـ server.
169                          </entry>
170                      </row>
171                      <row>
172                          <entry><code>compression</code></entry>
173                          <entry><code>boolean</code></entry>
174                          <entry><code>flase</code></entry>
175                          <entry>
176                             اعطها القيمة true إن اردت عمل ضغط للبيانت on-the-fly (إن صح التعبير "على الطاير").
177                          </entry>
178                      </row>
179                  </tbody>
180              </tgroup>
181          </table>
182    </sect2>
183    <sect2 id="zend.cache.backends.apc">
184        <title>Zend_Cache_Backend_APC</title>
185        <para>
186            هذه الـ backend تقوم بحفظ الـ cache records فى ذاكرة مشتركة من خلال الـ extension
187المسمى
188<ulink url="http://pecl.php.net/package/APC">APC</ulink> (Alternative PHP Cache).
189(بالطبع ستحتاج هذه الـ extension لتستطيع استخدام هذه الـ backend)
190        </para>
191        <para>
192            احترس: مع هذا الـ backend الـ tags غير مدعومة الى الأن .
193(لأن "doNotTestCacheValidity=true")
194        </para>
195        <para>
196            لا يوجد options لهذه الـ backend
197        </para>
198    </sect2>
199</sect1>
200<!--
201vim:se ts=4 sw=4 et:
202-->