diff --git a/reference/session/ini.xml b/reference/session/ini.xml index 6cd9a714a7..f926600680 100644 --- a/reference/session/ini.xml +++ b/reference/session/ini.xml @@ -1,5 +1,5 @@ - +
&reftitle.runtime; &extension.runtime; @@ -161,12 +161,27 @@ session.save_path defines the argument which is passed to the save handler. If you choose the default files - handler, this is the path where the files are created. - Defaults to /tmp. If - session.save_path's path depth is more than - 2, garbage collection will not be performed. See also - session_save_path. + handler, this is the path where the files are created. Defaults to + /tmp. See also + session_save_path. + + There is an optional N argument to this directive that determines + the number of directory levels your session files will be spread + around in. For example, setting to '5;/tmp' + may end up creating a session file and location like + /tmp/4/b/1/e/3/sess_4b1e384ad74619bd212e236e52a5a174If + . In order to use N you must create all of these + directories before use. A small shell script exists in + ext/session to do this, it's called + mod_files.sh. Also note that if N is + used and greater than 0 then automatic garbage collection will + not be performed, see a copy of &php.ini; for further + information. Also, if you use N, be sure to surround + session.save_path in + "quotes" because the separator (;) is + also used for comments in &php.ini;. + If you leave this set to a world-readable directory, such as