#47731 [NEW]: Misleading doc in php.ini for session.save_path and/or session.gc_maxlifetime

From: Date: Fri, 20 Mar 2009 13:28:51 +0000
Subject: #47731 [NEW]: Misleading doc in php.ini for session.save_path and/or session.gc_maxlifetime
Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-2017@lists.php.net to get a copy of this message
From:             chcaron at nrcan dot gc dot ca
Operating system: Linux
PHP version:      Irrelevant
PHP Bug Type:     Documentation problem
Bug description:  Misleading doc in php.ini for session.save_path and/or session.gc_maxlifetime

Description:
------------
In the php.ini file, here's what it says (for session.save_path):

##START##
; NOTE: If you are using the subdirectory option for storing session
files
;       (see session.save_path above), then garbage collection does *not*
;       happen automatically.  You will need to do your own garbage
;       collection through a shell script, cron entry, or some other
method.
;       For example, the following script would is the equivalent of
;       setting session.gc_maxlifetime to 1440 (1440 seconds = 24
minutes):
;          cd /path/to/sessions; find -cmin +24 | xargs rm 
##END##

On the website, here's what it says
(http://ca3.php.net/manual/en/session.configuration.php#ini.session.save-path):

##START##
Also note that if N is used and greater than 0 then automatic garbage
collection will not be performed
##END##

The documentation in php.ini is misleading as it makes you think that
using the session.save_path variable will prevent the garbage collector to
work. This isn't true. It would happen *only* if you are specifying "N",
and it "N" would be greater than 0.

Expected result:
----------------
The documentation in the php.ini file (either for "session.save_path" or
"session.gc_maxlifetime") should include the same information as found on
the website.


-- 
Edit bug report at http://bugs.php.net/?id=47731&edit=1
-- 
Try a CVS snapshot (PHP 5.2):        http://bugs.php.net/fix.php?id=47731&r=trysnapshot52
Try a CVS snapshot (PHP 5.3):        http://bugs.php.net/fix.php?id=47731&r=trysnapshot53
Try a CVS snapshot (PHP 6.0):        http://bugs.php.net/fix.php?id=47731&r=trysnapshot60
Fixed in CVS:                        http://bugs.php.net/fix.php?id=47731&r=fixedcvs
Fixed in CVS and need be documented: http://bugs.php.net/fix.php?id=47731&r=needdocs
Fixed in release:                    http://bugs.php.net/fix.php?id=47731&r=alreadyfixed
Need backtrace:                      http://bugs.php.net/fix.php?id=47731&r=needtrace
Need Reproduce Script:               http://bugs.php.net/fix.php?id=47731&r=needscript
Try newer version:                   http://bugs.php.net/fix.php?id=47731&r=oldversion
Not developer issue:                 http://bugs.php.net/fix.php?id=47731&r=support
Expected behavior:                   http://bugs.php.net/fix.php?id=47731&r=notwrong
Not enough info:                     http://bugs.php.net/fix.php?id=47731&r=notenoughinfo
Submitted twice:                     http://bugs.php.net/fix.php?id=47731&r=submittedtwice
register_globals:                    http://bugs.php.net/fix.php?id=47731&r=globals
PHP 4 support discontinued:          http://bugs.php.net/fix.php?id=47731&r=php4
Daylight Savings:                    http://bugs.php.net/fix.php?id=47731&r=dst
IIS Stability:                       http://bugs.php.net/fix.php?id=47731&r=isapi
Install GNU Sed:                     http://bugs.php.net/fix.php?id=47731&r=gnused
Floating point limitations:          http://bugs.php.net/fix.php?id=47731&r=float
No Zend Extensions:                  http://bugs.php.net/fix.php?id=47731&r=nozend
MySQL Configuration Error:           http://bugs.php.net/fix.php?id=47731&r=mysqlcfg



Thread (2 messages)

« previous php.doc.bugs (#2017) next »