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 <!--
 201 vim:se ts=4 sw=4 et:
 202 -->