session_gc
(PHP 7 >= 7.1.0)
session_gc — Perform session data garbage collection
Description
int session_gc ( void )
session_gc() is used to perform session data GC(garbage collection). PHP does probability based session GC by default.
Probability based GC works somewhat but it has few problems. 1) Low traffic sites' session data may not be deleted within the preferred duration. 2) High traffic sites' GC may be too frequent GC. 3) GC is performed on the user's request and the user will experience a GC delay.
Therefore, it is recommended to execute GC periodically for production systems using, e.g., "cron" for UNIX-like systems. Make sure to disable probability based GC by setting session.gc_probability to 0.
Return Values
session_gc() returns number of deleted session data for success, FALSE
for failure.
Old save handlers do not return number of deleted session data, but only success/failure flag. If this is the case, number of deleted session data became 1 regardless of actually deleted data.
Examples
Example #1 session_gc() example for task managers like cron
<?php
//?Note:?This?script?should?be?executed?by?the?same?user?of?web?server?process.
//?Need?active?session?to?initialize?session?data?storage?access.
session_start();
//?Executes?GC?immediately
session_gc();
//?Clean?up?session?ID?created?by?session_gc()
session_destroy();
?>
Example #2 session_gc() example for user accessible script
<?php
//?Note:?session_gc()?is?recommended?to?be?used?by?task?manager?script,?but
//?it?may?be?used?as?follows.
//?Used?for?last?GC?time?check
$gc_time?=?'/tmp/php_session_last_gc';
$gc_period?=?1800;
session_start();
//?Execute?GC?only?when?GC?period?elapsed.?
//?i.e.?Calling?session_gc()?every?request?is?waste?of?resources.?
if?(file_exists($gc_time))?{
????if?(filemtime($gc_time)?<?time()?-?$gc_period)?{
????????session_gc();
????????touch($gc_time);
????}
}?else?{
????touch($gc_time);
}
?>
See Also
- session_start() - Start new or resume existing session
- session_destroy() - Destroys all data registered to a session
← session_encode
session_get_cookie_params →
? 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
本文档系腾讯云开发者社区成员共同维护,如有问题请联系 cloudcommunity@tencent.com