الدالة 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 بالتخزين المؤقت للعميل / الوكيل.

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

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

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

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

المعامل

cache_limiter

إذا تم تحديد cache_limiter ، يتم تغيير اسم المحدد المؤقت الحالي إلى القيمة الجديدة.

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

القيمة الترويسات المرسلة
public Expires:ل في وقت ما في المستقبل ، وفقاsession.cache_expire

Cache-Control: public, max-age=(ل في وقت ما في المستقبل ، وفقاsession.cache_expire)

Last-Modified: بصمة وقت آخر تسجيل للجلسة

public_no_expire Cache-Control: private, max-age=(session.cache_expire في وقت ما في المستقبل), pre-check=(session.cache_expire في وقت ما في المستقبل)

Last-Modified: بصمة وقت آخر تسجيل للجلسة

private Expires: Thu, 26 Jul 2018 08:52:00 GMT

Cache-Control: private, max-age=(session.cache_expire في وقت ما في المستقبل), pre-check=(session.cache_expire في وقت ما في المستقبل)

Last-Modified: بصمة وقت آخر تسجيل للجلسة

no_cache Expires: Thu, 26 Jul 2018 08:52:00 GMT
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 />";

?>