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

<noinclude>{{DISPLAYTITLE:الدالة ()session_cache_expire في PHP}}</noinclude>
(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()‎‎). 

== المعاملات ==

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

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

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

== أمثلة ==
مثال 1: استخدام الدالة session_cache_expire ()‎‎<syntaxhighlight lang="php">
<?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";
?>
</syntaxhighlight>

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

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