عرض مصدر PHP/session cache limiter

<noinclude>{{DISPLAYTITLE:الدالة <code>session_cache_limiter()</code>‎ في PHP}}</noinclude>
PHP 4 >= 4.0.3, PHP 5, PHP 7)‎)

تعيد الدالة <code>session_cache_limiter()‎</code> أو تضبط محدّد ذاكرة التخزين المؤقتة.

== الوصف ==
<syntaxhighlight lang="php">
string session_cache_limiter ([ string $cache_limiter ] )‎
</syntaxhighlight>تعيد الدالة <code>session_cache_limiter()‎</code> اسم محدّد ذاكرة التخزين المؤقتة الحالية.

يحدّد محدّد ذاكرة التخزين المؤقت أيّة ذاكرة تخزين مؤقتة يتم من خلالها إرسال ترويسات HTTP إلى العميل. تحدّد هذه الترويسات القواعد التي قد يتم تخزين محتوى الصفحة بها مؤقتًا بواسطة العميل ووكلاء وسيطة (intermediate proxies). لا يسمح تعيين محدد ذاكرة التخزين المؤقتة إلى <code>nocache</code> بالتخزين المؤقت للعميل. 

تسمح القيمة <code>public</code> بالتخزين المؤقت من قبل الوكلاء والعميل. في حين أن القيمة <code>private</code> لا تسمح بالتخزين المؤقت من قبل الوكلاء وتسمح للعميل بتخزين المحتوى.

في الوضع private، قد تؤدي الترويسة <code>Expire</code> المرسلة إلى العميل إلى حدوث ارتباك لبعض المتصفحات بما في ذلك Firefox. يمكن تجنّب هكذا إشكال عن طريق استخدام وضع  <code>private_no_expire</code> والذي لن يسمح بإرسال الترويسة <code>Expire</code> إلى العميل.

سيؤدي تعيين محدد ذاكرة التخزين المؤقتة إلى <code><nowiki>''</nowiki></code> إلى إيقاف الإرسال التلقائي لترويسات ذاكرة التخزين المؤقتة بالكامل.

يُعاد تعيين محدد ذاكرة التخزين المؤقتة إلى القيمة الافتراضية المخزنة في <code>session.cache_limiter</code> عند وقت بدء الطلب. ستحتاج حينها إلى استدعاء الدالة <code>session_cache_limiter()‎</code> قبل كل طلب وقبل استدعاء الدالة <code>[[PHP/session start|session_start()]]</code>‎.

== المعاملات ==
<code>cache_limiter</code>

إذا ضُبِطَت قيمة <code>cache_limiter</code> ، فسيُغيّر اسم المحدد المؤقت الحالي إلى القيمة الجديدة.

القيم الممكنة
{| class="wikitable"
!القيمة
!الترويسات المرسلة
|-
|<code>public</code>
|<code>Expires:‎</code> في وقت ما في المستقبل ، وفقا لقيمة <code>session.cache_expire</code>.
<code>max-age ,public :Cache control=‎</code> في وقت ما في المستقبل، وفقًا لقيمة <code>session.cache_expire</code>.

<code>Last-Modified:‎</code> بصمة وقت آخر تسجيل للجلسة.
|-
|<code>public_no_expire</code>
|<code>max-age,public :Cache control=‎</code> (في وقت ما في المستقبل، وفقًا لقيمة session.cache_expire)
‎, pre-check=‎

(في وقت ما في المستقبل، وفقًا لقيمة <code>session.cache_expire</code>)

<code>Last-Modified</code>: بصمة وقت آخر تسجيل للجلسة.
|-
|<code>private</code>
|Thu, 26 Jul 2018 08:52:00 GMT:Expires

max-age,public :Cache control=( في وقت ما في المستقبل، وفقًا لقيمة pre-check, (session.cache_expire=(في وقت ما في المستقبل، وفقًا لقيمة <code>session.cache_expire</code>)

<code>Last-Modified:</code> بصمة وقت آخر تسجيل للجلسة.
|-
|<code>no_cache</code>
|<code>Thu, 26 Jul 2018 08:52:00 GMT:Expires</code>
<code>,Cache-Control: no-store, no-cache</code>

<code>,must-revalidate, post-check=0</code>

<code>pre-check=0</code>

<code>Pragma: no-cache</code>
|}

== القيم المعادة ==
تعيد الدالة <code>session_cache_limiter()‎</code> اسم محدّد ذاكرة التخزين المؤقتة الحالية.

== أمثلة ==
المثال 1: استعمال الدالة <code>session_cache_limiter()‎</code><syntaxhighlight lang="php">
<?php 

/*private ضبط محدّد ذاكرة التخزين المؤقتة إلى القيمة */ 

session_cache_limiter('private');
$cache_limiter = session_cache_limiter(); 

echo "The cache limiter is now set to $cache_limiter<br />";
?>


</syntaxhighlight>

==مصادر==
* [http://php.net/manual/en/function.session-cache-limiter.php صفحة الدالة session_cache_limiter‎ في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Session]]