الدالة `session_cache_limiter()`‎ في PHP

PHP 4 >= 4.0.3, PHP 5, PHP 7)‎)

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

الوصف

string session_cache_limiter ([ string $cache_limiter ] )‎

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

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

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

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

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

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

المعاملات

cache_limiter

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

القيم الممكنة

القيمة	الترويسات المرسلة
`public`	`Expires:‎` في وقت ما في المستقبل ، وفقا لقيمة `session.cache_expire`. `max-age ,public :Cache control=‎` في وقت ما في المستقبل، وفقًا لقيمة `session.cache_expire`. `Last-Modified:‎` بصمة وقت آخر تسجيل للجلسة.
`public_no_expire`	`max-age,public :Cache control=‎` (في وقت ما في المستقبل، وفقًا لقيمة session.cache_expire) ‎, pre-check=‎ (في وقت ما في المستقبل، وفقًا لقيمة `session.cache_expire`) `Last-Modified`: بصمة وقت آخر تسجيل للجلسة.
`private`	Thu, 26 Jul 2018 08:52:00 GMT:Expires max-age,public :Cache control=( في وقت ما في المستقبل، وفقًا لقيمة pre-check, (session.cache_expire=(في وقت ما في المستقبل، وفقًا لقيمة `session.cache_expire`) `Last-Modified:` بصمة وقت آخر تسجيل للجلسة.
`no_cache`	`Thu, 26 Jul 2018 08:52:00 GMT:Expires` `,Cache-Control: no-store, no-cache` `,must-revalidate, post-check=0` `pre-check=0` `Pragma: no-cache`

القيم المعادة

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

أمثلة

المثال 1: استعمال الدالة session_cache_limiter()‎

<?php 

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

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

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

مصادر

صفحة الدالة session_cache_limiter‎ في توثيق PHP الرسمي.