الدالة ()session_cache_expire في PHP

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

(PHP 4, PHP 4.4, PHP 5, PHP 7)

تعيد الدالة () session_cache_expire القيمة الحالية لزمن انتهاء الذاكرة المخبأة.

الوصف

int session_cache_expire ([ string $new_cache_expire ] )

تُعيد الدالة ()session_cache_expire الإعدادات الحالية لصلاحية الذاكرة المخبأة.

يُعاد ضبط قيمة صلاحية الذاكرة المخبأة المؤقتة (cache)للجلسة تلقائيًا للقيمة 180 المُخزنة في خيار الضبط session.cache_expire عند طلب بدء الجلسة. لذلك يجب إستدعاء ()session_cache_expire قبل كُل طلب (وقبل إستدعاء الدالة session_start()‎‎). 

المعاملات

new_cache_expire

إذا أُستخدم المعامل new_cache_expire فإن القيمة الحالية لصلاحية الذاكرة المخبأة تبدّل إلى new_cache_expire.

لاحظ أن خيار الضبط new_cache_expire يحتوي على قيمة فقط إذا ضبط محدّد ذاكرة التخزين المؤقتة للجلسة (session.cache_limiter) بقيمة مختلفة عن nocache.

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

تُعيد الدالة القيمة الحالية لصلاحية الذاكرة المخبأة للجلسة مقدرةً بالدقائق، وقيمتها الافتراضية 180.

أمثلة

مثال 1: استخدام الدالة session_cache_expire ()‎‎

<?php

// 'Private'ضبط مُحدد ذاكرة التخزين المؤقتة إلى 

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

// ضبط مُدة صلاحية الذاكرة الإنتقالية للجلسة إلى 30 دقيقة
session_cache_expire(30);
$cache_expire = session_cache_expire();

// بدء الجلسة

session_start();

echo "The cache limiter is now set to $cache_limiter<br />";
echo "The cached session pages expire after $cache_expire minutes";
?>

انظر أيضًا

  • session.cache_expire
  • session.cache_limiter
  • الدالة ()‎‎‎session.cache_limiter: تحصل على أو تحدّث قيمة مُحدد الذاكرة المخبأة للجلسة.

مصادر

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