الدالة 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_limiter: تعيد أو تضبط محدّد ذاكرة التخزين المؤقتة.

مصادر

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