reference/session/ini.xml
d8bc36d413b4458bc27ecc41517f26f6d1df3f27
d8bc36d413b4458bc27ecc41517f26f6d1df3f27
...
...
@@ -19,217 +19,217 @@
19
19
<row>
20
20
<entry><link linkend="ini.session.save-path">session.save_path</link></entry>
21
21
<entry>""</entry>
22
-
<entry>PHP_INI_ALL</entry>
22
+
<entry><constant>INI_ALL</constant></entry>
23
23
<entry></entry>
24
24
</row>
25
25
<row>
26
26
<entry><link linkend="ini.session.name">session.name</link></entry>
27
27
<entry>"PHPSESSID"</entry>
28
-
<entry>PHP_INI_ALL</entry>
28
+
<entry><constant>INI_ALL</constant></entry>
29
29
<entry></entry>
30
30
</row>
31
31
<row>
32
32
<entry><link linkend="ini.session.save-handler">session.save_handler</link></entry>
33
33
<entry>"files"</entry>
34
-
<entry>PHP_INI_ALL</entry>
34
+
<entry><constant>INI_ALL</constant></entry>
35
35
<entry></entry>
36
36
</row>
37
37
<row>
38
38
<entry><link linkend="ini.session.auto-start">session.auto_start</link></entry>
39
39
<entry>"0"</entry>
40
-
<entry>PHP_INI_PERDIR</entry>
40
+
<entry><constant>INI_PERDIR</constant></entry>
41
41
<entry></entry>
42
42
</row>
43
43
<row>
44
44
<entry><link linkend="ini.session.gc-probability">session.gc_probability</link></entry>
45
45
<entry>"1"</entry>
46
-
<entry>PHP_INI_ALL</entry>
46
+
<entry><constant>INI_ALL</constant></entry>
47
47
<entry></entry>
48
48
</row>
49
49
<row>
50
50
<entry><link linkend="ini.session.gc-divisor">session.gc_divisor</link></entry>
51
51
<entry>"100"</entry>
52
-
<entry>PHP_INI_ALL</entry>
52
+
<entry><constant>INI_ALL</constant></entry>
53
53
<entry></entry>
54
54
</row>
55
55
<row>
56
56
<entry><link linkend="ini.session.gc-maxlifetime">session.gc_maxlifetime</link></entry>
57
57
<entry>"1440"</entry>
58
-
<entry>PHP_INI_ALL</entry>
58
+
<entry><constant>INI_ALL</constant></entry>
59
59
<entry></entry>
60
60
</row>
61
61
<row>
62
62
<entry><link linkend="ini.session.serialize-handler">session.serialize_handler</link></entry>
63
63
<entry>"php"</entry>
64
-
<entry>PHP_INI_ALL</entry>
64
+
<entry><constant>INI_ALL</constant></entry>
65
65
<entry></entry>
66
66
</row>
67
67
<row>
68
68
<entry><link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link></entry>
69
69
<entry>"0"</entry>
70
-
<entry>PHP_INI_ALL</entry>
70
+
<entry><constant>INI_ALL</constant></entry>
71
71
<entry></entry>
72
72
</row>
73
73
<row>
74
74
<entry><link linkend="ini.session.cookie-path">session.cookie_path</link></entry>
75
75
<entry>"/"</entry>
76
-
<entry>PHP_INI_ALL</entry>
76
+
<entry><constant>INI_ALL</constant></entry>
77
77
<entry></entry>
78
78
</row>
79
79
<row>
80
80
<entry><link linkend="ini.session.cookie-domain">session.cookie_domain</link></entry>
81
81
<entry>""</entry>
82
-
<entry>PHP_INI_ALL</entry>
82
+
<entry><constant>INI_ALL</constant></entry>
83
83
<entry></entry>
84
84
</row>
85
85
<row>
86
86
<entry><link linkend="ini.session.cookie-secure">session.cookie_secure</link></entry>
87
-
<entry>""</entry>
88
-
<entry>PHP_INI_ALL</entry>
89
-
<entry></entry>
87
+
<entry>"0"</entry>
88
+
<entry><constant>INI_ALL</constant></entry>
89
+
<entry>Prior to PHP 7.2.0, the default was <literal>""</literal>.</entry>
90
90
</row>
91
91
<row>
92
92
<entry><link linkend="ini.session.cookie-httponly">session.cookie_httponly</link></entry>
93
-
<entry>""</entry>
94
-
<entry>PHP_INI_ALL</entry>
95
-
<entry></entry>
93
+
<entry>"0"</entry>
94
+
<entry><constant>INI_ALL</constant></entry>
95
+
<entry>Prior to PHP 7.2.0, the default was <literal>""</literal>.</entry>
96
96
</row>
97
97
<row>
98
98
<entry><link linkend="ini.session.cookie-samesite">session.cookie_samesite</link></entry>
99
99
<entry>""</entry>
100
-
<entry>PHP_INI_ALL</entry>
100
+
<entry><constant>INI_ALL</constant></entry>
101
101
<entry>Available as of PHP 7.3.0.</entry>
102
102
</row>
103
103
<row>
104
104
<entry><link linkend="ini.session.use-strict-mode">session.use_strict_mode</link></entry>
105
105
<entry>"0"</entry>
106
-
<entry>PHP_INI_ALL</entry>
106
+
<entry><constant>INI_ALL</constant></entry>
107
107
<entry></entry>
108
108
</row>
109
109
<row>
110
110
<entry><link linkend="ini.session.use-cookies">session.use_cookies</link></entry>
111
111
<entry>"1"</entry>
112
-
<entry>PHP_INI_ALL</entry>
112
+
<entry><constant>INI_ALL</constant></entry>
113
113
<entry></entry>
114
114
</row>
115
115
<row>
116
116
<entry><link linkend="ini.session.use-only-cookies">session.use_only_cookies</link></entry>
117
117
<entry>"1"</entry>
118
-
<entry>PHP_INI_ALL</entry>
118
+
<entry><constant>INI_ALL</constant></entry>
119
119
<entry></entry>
120
120
</row>
121
121
<row>
122
122
<entry><link linkend="ini.session.referer-check">session.referer_check</link></entry>
123
123
<entry>""</entry>
124
-
<entry>PHP_INI_ALL</entry>
124
+
<entry><constant>INI_ALL</constant></entry>
125
125
<entry></entry>
126
126
</row>
127
127
<row>
128
128
<entry><link linkend="ini.session.cache-limiter">session.cache_limiter</link></entry>
129
129
<entry>"nocache"</entry>
130
-
<entry>PHP_INI_ALL</entry>
130
+
<entry><constant>INI_ALL</constant></entry>
131
131
<entry></entry>
132
132
</row>
133
133
<row>
134
134
<entry><link linkend="ini.session.cache-expire">session.cache_expire</link></entry>
135
135
<entry>"180"</entry>
136
-
<entry>PHP_INI_ALL</entry>
136
+
<entry><constant>INI_ALL</constant></entry>
137
137
<entry></entry>
138
138
</row>
139
139
<row>
140
140
<entry><link linkend="ini.session.use-trans-sid">session.use_trans_sid</link></entry>
141
141
<entry>"0"</entry>
142
-
<entry>PHP_INI_ALL</entry>
142
+
<entry><constant>INI_ALL</constant></entry>
143
143
<entry></entry>
144
144
</row>
145
145
<row>
146
146
<entry><link linkend="ini.session.trans-sid-tags">session.trans_sid_tags</link></entry>
147
147
<entry>"a=href,area=href,frame=src,form="</entry>
148
-
<entry>PHP_INI_ALL</entry>
148
+
<entry><constant>INI_ALL</constant></entry>
149
149
<entry>Available as of PHP 7.1.0.</entry>
150
150
</row>
151
151
<row>
152
152
<entry><link linkend="ini.session.trans-sid-hosts">session.trans_sid_hosts</link></entry>
153
153
<entry><literal>$_SERVER['HTTP_HOST']</literal></entry>
154
-
<entry>PHP_INI_ALL</entry>
154
+
<entry><constant>INI_ALL</constant></entry>
155
155
<entry>Available as of PHP 7.1.0.</entry>
156
156
</row>
157
157
<row>
158
158
<entry><link linkend="ini.session.sid-length">session.sid_length</link></entry>
159
159
<entry>"32"</entry>
160
-
<entry>PHP_INI_ALL</entry>
160
+
<entry><constant>INI_ALL</constant></entry>
161
161
<entry>Available as of PHP 7.1.0.</entry>
162
162
</row>
163
163
<row>
164
164
<entry><link linkend="ini.session.sid-bits-per-character">session.sid_bits_per_character</link></entry>
165
165
<entry>"4"</entry>
166
-
<entry>PHP_INI_ALL</entry>
166
+
<entry><constant>INI_ALL</constant></entry>
167
167
<entry>Available as of PHP 7.1.0.</entry>
168
168
</row>
169
169
<row>
170
170
<entry><link linkend="ini.session.upload-progress.enabled">session.upload_progress.enabled</link></entry>
171
171
<entry>"1"</entry>
172
-
<entry>PHP_INI_PERDIR</entry>
172
+
<entry><constant>INI_PERDIR</constant></entry>
173
173
<entry></entry>
174
174
</row>
175
175
<row>
176
176
<entry><link linkend="ini.session.upload-progress.cleanup">session.upload_progress.cleanup</link></entry>
177
177
<entry>"1"</entry>
178
-
<entry>PHP_INI_PERDIR</entry>
178
+
<entry><constant>INI_PERDIR</constant></entry>
179
179
<entry></entry>
180
180
</row>
181
181
<row>
182
182
<entry><link linkend="ini.session.upload-progress.prefix">session.upload_progress.prefix</link></entry>
183
183
<entry>"upload_progress_"</entry>
184
-
<entry>PHP_INI_PERDIR</entry>
184
+
<entry><constant>INI_PERDIR</constant></entry>
185
185
<entry></entry>
186
186
</row>
187
187
<row>
188
188
<entry><link linkend="ini.session.upload-progress.name">session.upload_progress.name</link></entry>
189
189
<entry>"PHP_SESSION_UPLOAD_PROGRESS"</entry>
190
-
<entry>PHP_INI_PERDIR</entry>
190
+
<entry><constant>INI_PERDIR</constant></entry>
191
191
<entry></entry>
192
192
</row>
193
193
<row>
194
194
<entry><link linkend="ini.session.upload-progress.freq">session.upload_progress.freq</link></entry>
195
195
<entry>"1%"</entry>
196
-
<entry>PHP_INI_PERDIR</entry>
196
+
<entry><constant>INI_PERDIR</constant></entry>
197
197
<entry></entry>
198
198
</row>
199
199
<row>
200
200
<entry><link linkend="ini.session.upload-progress.min-freq">session.upload_progress.min_freq</link></entry>
201
201
<entry>"1"</entry>
202
-
<entry>PHP_INI_PERDIR</entry>
202
+
<entry><constant>INI_PERDIR</constant></entry>
203
203
<entry></entry>
204
204
</row>
205
205
<row>
206
206
<entry><link linkend="ini.session.lazy-write">session.lazy_write</link></entry>
207
207
<entry>"1"</entry>
208
-
<entry>PHP_INI_ALL</entry>
208
+
<entry><constant>INI_ALL</constant></entry>
209
209
<entry></entry>
210
210
</row>
211
211
<row>
212
212
<entry><link linkend="ini.session.hash-function">session.hash_function</link></entry>
213
213
<entry>"0"</entry>
214
-
<entry>PHP_INI_ALL</entry>
214
+
<entry><constant>INI_ALL</constant></entry>
215
215
<entry>Removed as of PHP 7.1.0.</entry>
216
216
</row>
217
217
<row>
218
218
<entry><link linkend="ini.session.hash-bits-per-character">session.hash_bits_per_character</link></entry>
219
219
<entry>"4"</entry>
220
-
<entry>PHP_INI_ALL</entry>
220
+
<entry><constant>INI_ALL</constant></entry>
221
221
<entry>Removed as of PHP 7.1.0.</entry>
222
222
</row>
223
223
<row>
224
224
<entry><link linkend="ini.session.entropy-file">session.entropy_file</link></entry>
225
225
<entry>""</entry>
226
-
<entry>PHP_INI_ALL</entry>
226
+
<entry><constant>INI_ALL</constant></entry>
227
227
<entry>Removed as of PHP 7.1.0.</entry>
228
228
</row>
229
229
<row>
230
230
<entry><link linkend="ini.session.entropy-length">session.entropy_length</link></entry>
231
231
<entry>"0"</entry>
232
-
<entry>PHP_INI_ALL</entry>
232
+
<entry><constant>INI_ALL</constant></entry>
233
233
<entry>Removed as of PHP 7.1.0</entry>
234
234
</row>
235
235
</tbody>
...
...
@@ -367,8 +367,7 @@
367
367
<literal>php_binary</literal>) and WDDX are supported (name
368
368
<literal>wddx</literal>). WDDX is only available, if PHP is
369
369
compiled with <link linkend="ref.wddx">WDDX
370
-
support</link>. <literal>php_serialize</literal> is available
371
-
from PHP 5.5.4. <literal>php_serialize</literal> uses plain
370
+
support</link>. <literal>php_serialize</literal> uses plain
372
371
serialize/unserialize function internally and does not have
373
372
limitations that <literal>php</literal>
374
373
and <literal>php_binary</literal> have. Older serialize handlers
...
...
@@ -429,6 +428,7 @@
429
428
(depending on <link
430
429
linkend="ini.session.gc-probability">session.gc_probability</link> and
431
430
<link linkend="ini.session.gc-divisor">session.gc_divisor</link>).
431
+
Defaults to <literal>1440</literal> (24 minutes).
432
432
</simpara>
433
433
<note>
434
434
<simpara>
...
...
@@ -472,7 +472,7 @@
472
472
which are available on many Unix systems.
473
473
</simpara>
474
474
<simpara>
475
-
This feature is supported on Windows since PHP 5.3.3. Setting
475
+
This feature is supported on Windows. Setting
476
476
<literal>session.entropy_length</literal> to a non zero value
477
477
will make PHP use the Windows Random API as entropy source.
478
478
</simpara>
...
...
@@ -481,9 +481,9 @@
481
481
Removed in PHP 7.1.0.
482
482
</simpara>
483
483
<simpara>
484
-
As of PHP 5.4.0 <literal>session.entropy_file</literal> defaults
484
+
<literal>session.entropy_file</literal> defaults
485
485
to <literal>/dev/urandom</literal> or <literal>/dev/arandom</literal>
486
-
if it is available. In PHP 5.3.0 this directive is left empty by default.
486
+
if it is available.
487
487
</simpara>
488
488
</note>
489
489
</listitem>
...
...
@@ -565,9 +565,9 @@
565
565
<literal>session.use_only_cookies</literal> specifies whether
566
566
the module will <emphasis role="strong">only</emphasis> use
567
567
cookies to store the session id on the client side.
568
-
Enabling this setting prevents attacks involved passing session
569
-
ids in URLs.
570
-
Defaults to <literal>1</literal> (enabled) since PHP 5.3.0.
568
+
Enabling this setting prevents attacks that involve passing session
569
+
IDs in URLs.
570
+
Defaults to <literal>1</literal> (enabled).
571
571
</simpara>
572
572
</listitem>
573
573
</varlistentry>
...
...
@@ -635,8 +635,10 @@
635
635
<listitem>
636
636
<simpara>
637
637
<literal>session.cookie_secure</literal> specifies whether
638
-
cookies should only be sent over secure connections. Defaults to
639
-
<literal>off</literal>.
638
+
cookies should only be sent over secure connections. With this option set
639
+
to <literal>on</literal>, sessions only work with HTTPS connections.
640
+
If it is <literal>off</literal>, then sessions work with both HTTP and
641
+
HTTPS connections. Defaults to <literal>off</literal>.
640
642
See also
641
643
<function>session_get_cookie_params</function> and
642
644
<function>session_set_cookie_params</function>.
...
...
@@ -674,7 +676,7 @@
674
676
An empty value means that no SameSite cookie attribute will be set.
675
677
<literal>Lax</literal> and <literal>Strict</literal> mean that the cookie
676
678
will not be sent cross-domain for POST requests; <literal>Lax</literal>
677
-
will sent the cookie for cross-domain GET requests, while <literal>Strict</literal>
679
+
will send the cookie for cross-domain GET requests, while <literal>Strict</literal>
678
680
will not.
679
681
</simpara>
680
682
</listitem>
...
...
@@ -835,7 +837,7 @@
835
837
</term>
836
838
<listitem>
837
839
<simpara>
838
-
<literal>session.sid_per_character</literal> allows you to specify the
840
+
<literal>session.sid_bits_per_character</literal> allows you to specify the
839
841
number of bits in encoded session ID character. The possible values are
840
842
'4' (0-9, a-f), '5' (0-9, a-v), and '6' (0-9, a-z, A-Z, "-", ",").
841
843
</simpara>
...
...
@@ -865,7 +867,7 @@
865
867
'1' means SHA-1 (160 bits).
866
868
</simpara>
867
869
<para>
868
-
Since PHP 5.3.0 it is also possible to specify any of the algorithms
870
+
It is also possible to specify any of the algorithms
869
871
provided by the <link linkend="ref.hash">hash extension</link> (if it is
870
872
available), like <literal>sha512</literal> or
871
873
<literal>whirlpool</literal>. A complete list of supported algorithms can
...
...
@@ -873,7 +875,7 @@
873
875
</para>
874
876
<note>
875
877
<simpara>
876
-
This setting was introduced in PHP 5. Removed in PHP 7.1.0.
878
+
Removed in PHP 7.1.0.
877
879
</simpara>
878
880
</note>
879
881
</listitem>
880
882