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

   1 <sect1 id="zend.cache.theory">
   2     <title>مفهوم الـ caching </title>
   3     <para>
   4         هناك ثلاث مفاهيم رئيسية فى Zend_Cache. الأول هو المعرف المميز و هو عيارة عن string
   5 و الذى يستخدم لتعريف البيانات المسجلة فى الـ cache.
   6 الثانى هو التعليمة <code>'lifeTime'</code> كما رأيتها فى المثال السابق, هى تعرف الفترة الزمنية التى
   7 يتم اعتبار البيانات المحفوظة فى الـ cache و بهذا المعرف قابلة للإستخدام "طازجة" .
   8 المفهوم الثالث هو التنفيذ الشرطى للأكواد, حيث يتم اهمال جزء من الكود و لا يتم تنفيذه و هذا يزيد من كفائة الأداء (performance) .
   9 الدالة الأساسية (<code>()Zend_Cache_Core::get</code>) تم تصميمها لتعيد false
  10  عندما لا تجد البيانات المطلوبة فى الـ cache قابلة للإستخدام .
  11 هذا يسمح للمستخدم النهائى (انت المبرمج) من تحديد جزء من الكود الذى يريد عمل cache له داخل جملة
  12 <code>{ ... }()if</code> حيث ان الشرط هو هذه الدالة من Zend_Cache .
  13 فى نهاية هذه البلوكات يجب ان تقوم بحفظ الناتج , بإستخدام
  14 (<code>()Zend_Cache_Core::save</code>).
  15     </para>
  16     <note><para>
  17         عملية التنفيذ الشرطى للأكواد لا تكن مهمة فى بعض الحالات ( مثل إستخدام الـ frontend المسمى
  18 <code>Function</code> ) حيث سيكون الجزء المنطقى من الكود معرف داخل الـ frontend نفسه.
  19     </para></note>
  20     <note><para>
  21         المصطلح 'Cache hit' و الذى رأيته فى المثال نستخدمه للتعبير عن انه تم إيجاد بيانت فى الـ cache تنتمى
  22 لهذا المعرف و هذه البيانات قابلة للإستخدام و "طازجة" (بمعنى اخر لم تنتهى فترة صلاحيتها).
  23 المصطلح 'cache miss' هو عكس ما سبق, فعندما يحدث cache miss يجب ان تقوم بإنتاج بياناتك من
  24 جديد (كما يحدث فى الأوضاع الطبيعية) ثم تقم بعمل cache لها .
  25 و عندما يحدث cache hit تقم الـ backend تلقائياً بجلب البيانات من الـ cache .
  26
  27     </para></note>
  28     <sect2 id="zend.cache.factory">
  29         <title>الـ factory method فى <code>Zend_Cache</code></title>
  30         <para>
  31             طريقة جيدة لإنشاء frontend instance قابل لإستخدام من <code>Zend_Cache</code> نستعرضها فى
  32 المثال التالى :
  33             <programlisting role="php"><![CDATA[<?php
  34
  35 # We "load" the Zend_Cache factory
  36 require 'Zend/Cache.php';
  37
  38 # We choose a backend (for example 'File' or 'Sqlite'...)
  39 $backendName = '[...]';
  40
  41 # We choose a frontend (for example 'Core', 'Output', 'Page'...)
  42 $frontendName = '[...]';
  43
  44 # We set an array of options for the choosen frontend
  45 $frontendOptions = array([...]);
  46
  47 # We set an array of options for the choosen backend
  48 $backendOptions = array([...]);
  49
  50 # We make the good instance
  51 # (of course, the two last arguments are optional)
  52 $cache = Zend_Cache::factory($frontendName, $backendName, $frontendOptions, $backendOptions);
  53
  54 ?>]]></programlisting>
  55         </para>
  56         <para>
  57             فى الأمثلة التالية سنعتبر ان المتغير <code>cache$</code> يحتوى frontend instance صالح للإستخدام
  58 كما هو موضح فى المثال السابق, و انك تفهم كيفية تمرير parameters للـ backends التى تود إستخدامها.
  59         </para>
  60         <note><para>
  61             دائما إستخدم <code>()Zend_Cache::factory</code> لتنشئ frontend instance .
  62 إنشاء  الـ frontend instance و الـ backends instance بنفسك مباشرة لن يعمل كما تتوقع.
  63         </para></note>
  64     </sect2>
  65
  66     <sect2 id="zend.cache.tags">
  67         <title>إستخدام الـ tags</title>
  68         <para>
  69             الـ tags طرق لتقسيم البيانات فى الـ cache الى اقسام معرفة, عندما تقم بحفظ cache بإستخدام
  70 <code>()save</code> يمكنك ان تقم بتمرير array تحتوى على الـ tags التى تتوافق مع هذا الـ
  71 record (او البيانت المخزنة فى الـ cache ) .
  72 بالتالى ستستطيع حذف كل الـ cache records المنسوبة الى tag او مجموعة tags محددة.
  73         </para>
  74         <programlisting role="php"><![CDATA[<?php
  75
  76 $cache->save($huge_data, 'myUniqueID', array('tagA', 'tagB', 'tagC'));
  77
  78 ?>]]></programlisting>
  79     </sect2>
  80     <sect2 id="zend.cache.clean">
  81         <title>تنظيف الـ cache</title>
  82         <para>
  83             لحذف او تحديد معرف cache على انه غير قابل للإستخدام, يمكنك استخدام <code>()remove</code>
  84  كما فى المثال التالى :
  85         </para>
  86         <programlisting role="php"><![CDATA[<?php
  87
  88 $cache->remove('idToRemove');
  89
  90 ?>]]></programlisting>
  91         <para>
  92             لحذف او تحديد اكثر من معرف cache على انهم غير قابلين للإستخدام, يمكنك استخدام
  93 <code>()clean</code> , على سبيل المثال يمكنك حذف كل الـ cache records .
  94         </para>
  95         <programlisting role="php"><![CDATA[<?php
  96
  97 // clean all records
  98 $cache->clean(Zend_Cache::CLEANING_MODE_ALL);
  99
 100 // clean only outdated
 101 $cache->clean(Zend_Cache::CLEANING_MODE_OLD);
 102
 103 ?>]]>   </programlisting>
 104         <para>
 105             إن اردت حذف الـ cache records التى تنتمى الى tags محددة, مثلا 'tagA' و 'tagC'
 106 يمكنك استخدام :
 107         </para>
 108         <programlisting role="php"><![CDATA[<?php
 109
 110 $cache->clean(Zend_Cache::CLEANING_MODE_MATCHING_TAG, array('tagA', 'tagC'));
 111
 112 ?>]]>   </programlisting>
 113         <para>
 114             الـ cleaning modes المتوفرة هى :
 115 <code>CLEANING_MODE_ALL</code> تقوم بحذف كل الـ cache records الموجودة
 116
 117 ,  <code>CLEANING_MODE_OLD</code> تقوم بحذف الـ records القديمة او الغير
 118  صالحة للإستخدام
 119 ,
 120  <code>CLEANING_MODE_MATCHING_TAG</code> تقوم بحذف كل الـ records التى تنتمى الى مجموعة tags محددة
 121 ,<code>CLEANING_MODE_NOT_MATCHING_TAG</code> تقوم بحذف كل الـ records
 122 التى لا تنتمى الى مجموعة الـ tags الممررة.
 123
 124         </para>
 125     </sect2>
 126 </sect1>
 127 <!--
 128 vim:se ts=4 sw=4 et:
 129 -->