reference/opcache/ini.xml
d4d5216e7a965ca194f6b1c9dee84cecab2674e5
...
...
@@ -1,6 +1,6 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
<sect1 xml:id="opcache.configuration" xmlns="http://docbook.org/ns/docbook">
3
+
<sect1 xml:id="opcache.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
4
4
&reftitle.runtime;
5
5
&extension.runtime;
6
6
<para>
...
...
@@ -19,344 +19,350 @@
19
19
<row>
20
20
<entry><link linkend="ini.opcache.enable">opcache.enable</link></entry>
21
21
<entry>"1"</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.opcache.enable-cli">opcache.enable_cli</link></entry>
27
27
<entry>"0"</entry>
28
-
<entry>PHP_INI_SYSTEM</entry>
28
+
<entry><constant>INI_SYSTEM</constant></entry>
29
29
<entry>Between PHP 7.1.2 and 7.1.6 inclusive, the default was "1"</entry>
30
30
</row>
31
31
<row>
32
32
<entry><link
33
33
linkend="ini.opcache.memory-consumption">opcache.memory_consumption</link></entry>
34
34
<entry>"128"</entry>
35
-
<entry>PHP_INI_SYSTEM</entry>
35
+
<entry><constant>INI_SYSTEM</constant></entry>
36
36
<entry></entry>
37
37
</row>
38
38
<row>
39
39
<entry><link linkend="ini.opcache.interned-strings-buffer">opcache.interned_strings_buffer</link></entry>
40
40
<entry>"8"</entry>
41
-
<entry>PHP_INI_SYSTEM</entry>
41
+
<entry><constant>INI_SYSTEM</constant></entry>
42
42
<entry></entry>
43
43
</row>
44
44
<row>
45
45
<entry><link linkend="ini.opcache.max-accelerated-files">opcache.max_accelerated_files</link></entry>
46
46
<entry>"10000"</entry>
47
-
<entry>PHP_INI_SYSTEM</entry>
47
+
<entry><constant>INI_SYSTEM</constant></entry>
48
48
<entry></entry>
49
49
</row>
50
50
<row>
51
51
<entry><link linkend="ini.opcache.max-wasted-percentage">opcache.max_wasted_percentage</link></entry>
52
52
<entry>"5"</entry>
53
-
<entry>PHP_INI_SYSTEM</entry>
53
+
<entry><constant>INI_SYSTEM</constant></entry>
54
54
<entry></entry>
55
55
</row>
56
56
<row>
57
57
<entry><link linkend="ini.opcache.use-cwd">opcache.use_cwd</link></entry>
58
58
<entry>"1"</entry>
59
-
<entry>PHP_INI_SYSTEM</entry>
59
+
<entry><constant>INI_SYSTEM</constant></entry>
60
60
<entry></entry>
61
61
</row>
62
62
<row>
63
63
<entry><link linkend="ini.opcache.validate-timestamps">opcache.validate_timestamps</link></entry>
64
64
<entry>"1"</entry>
65
-
<entry>PHP_INI_ALL</entry>
65
+
<entry><constant>INI_ALL</constant></entry>
66
66
<entry></entry>
67
67
</row>
68
68
<row>
69
69
<entry><link linkend="ini.opcache.revalidate-freq">opcache.revalidate_freq</link></entry>
70
70
<entry>"2"</entry>
71
-
<entry>PHP_INI_ALL</entry>
71
+
<entry><constant>INI_ALL</constant></entry>
72
72
<entry></entry>
73
73
</row>
74
74
<row>
75
75
<entry><link linkend="ini.opcache.revalidate-path">opcache.revalidate_path</link></entry>
76
76
<entry>"0"</entry>
77
-
<entry>PHP_INI_ALL</entry>
77
+
<entry><constant>INI_ALL</constant></entry>
78
78
<entry></entry>
79
79
</row>
80
80
<row>
81
81
<entry><link linkend="ini.opcache.save-comments">opcache.save_comments</link></entry>
82
82
<entry>"1"</entry>
83
-
<entry>PHP_INI_SYSTEM</entry>
83
+
<entry><constant>INI_SYSTEM</constant></entry>
84
84
<entry></entry>
85
85
</row>
86
86
<row>
87
87
<entry><link linkend="ini.opcache.fast-shutdown">opcache.fast_shutdown</link></entry>
88
88
<entry>"0"</entry>
89
-
<entry>PHP_INI_SYSTEM</entry>
89
+
<entry><constant>INI_SYSTEM</constant></entry>
90
90
<entry>Removed in PHP 7.2.0</entry>
91
91
</row>
92
92
<row>
93
93
<entry><link linkend="ini.opcache.enable-file-override">opcache.enable_file_override</link></entry>
94
94
<entry>"0"</entry>
95
-
<entry>PHP_INI_SYSTEM</entry>
95
+
<entry><constant>INI_SYSTEM</constant></entry>
96
96
<entry></entry>
97
97
</row>
98
98
<row>
99
99
<entry><link linkend="ini.opcache.optimization-level">opcache.optimization_level</link></entry>
100
100
<entry>"0x7FFEBFFF"</entry>
101
-
<entry>PHP_INI_SYSTEM</entry>
101
+
<entry><constant>INI_SYSTEM</constant></entry>
102
102
<entry>Changed from 0x7FFFBFFF in PHP 7.3.0</entry>
103
103
</row>
104
104
<row>
105
105
<entry><link linkend="ini.opcache.inherited-hack">opcache.inherited_hack</link></entry>
106
106
<entry>"1"</entry>
107
-
<entry>PHP_INI_SYSTEM</entry>
107
+
<entry><constant>INI_SYSTEM</constant></entry>
108
108
<entry>Removed in PHP 7.3.0</entry>
109
109
</row>
110
110
<row>
111
111
<entry><link linkend="ini.opcache.dups-fix">opcache.dups_fix</link></entry>
112
112
<entry>"0"</entry>
113
-
<entry>PHP_INI_ALL</entry>
113
+
<entry><constant>INI_ALL</constant></entry>
114
114
<entry></entry>
115
115
</row>
116
116
<row>
117
117
<entry><link linkend="ini.opcache.blacklist-filename">opcache.blacklist_filename</link></entry>
118
118
<entry>""</entry>
119
-
<entry>PHP_INI_SYSTEM</entry>
119
+
<entry><constant>INI_SYSTEM</constant></entry>
120
120
<entry></entry>
121
121
</row>
122
122
<row>
123
123
<entry><link linkend="ini.opcache.max-file-size">opcache.max_file_size</link></entry>
124
124
<entry>"0"</entry>
125
-
<entry>PHP_INI_SYSTEM</entry>
125
+
<entry><constant>INI_SYSTEM</constant></entry>
126
126
<entry></entry>
127
127
</row>
128
128
<row>
129
129
<entry><link linkend="ini.opcache.consistency-checks">opcache.consistency_checks</link></entry>
130
130
<entry>"0"</entry>
131
-
<entry>PHP_INI_ALL</entry>
132
-
<entry></entry>
131
+
<entry><constant>INI_ALL</constant></entry>
132
+
<entry>Disabled as of 8.1.18 and 8.2.5. Removed as of PHP 8.3.0.</entry>
133
133
</row>
134
134
<row>
135
135
<entry><link linkend="ini.opcache.force-restart-timeout">opcache.force_restart_timeout</link></entry>
136
136
<entry>"180"</entry>
137
-
<entry>PHP_INI_SYSTEM</entry>
137
+
<entry><constant>INI_SYSTEM</constant></entry>
138
138
<entry></entry>
139
139
</row>
140
140
<row>
141
141
<entry><link linkend="ini.opcache.error-log">opcache.error_log</link></entry>
142
142
<entry>""</entry>
143
-
<entry>PHP_INI_SYSTEM</entry>
143
+
<entry><constant>INI_SYSTEM</constant></entry>
144
144
<entry></entry>
145
145
</row>
146
146
<row>
147
147
<entry><link linkend="ini.opcache.log-verbosity-level">opcache.log_verbosity_level</link></entry>
148
148
<entry>"1"</entry>
149
-
<entry>PHP_INI_SYSTEM</entry>
149
+
<entry><constant>INI_SYSTEM</constant></entry>
150
150
<entry></entry>
151
151
</row>
152
152
<row>
153
+
<entry><link linkend="ini.opcache.record-warnings">opcache.record_warnings</link></entry>
154
+
<entry>"0"</entry>
155
+
<entry><constant>INI_SYSTEM</constant></entry>
156
+
<entry>Available as of PHP 8.0.0</entry>
157
+
</row>
158
+
<row>
153
159
<entry><link linkend="ini.opcache.preferred-memory-model">opcache.preferred_memory_model</link></entry>
154
160
<entry>""</entry>
155
-
<entry>PHP_INI_SYSTEM</entry>
161
+
<entry><constant>INI_SYSTEM</constant></entry>
156
162
<entry></entry>
157
163
</row>
158
164
<row>
159
165
<entry><link linkend="ini.opcache.protect-memory">opcache.protect_memory</link></entry>
160
166
<entry>"0"</entry>
161
-
<entry>PHP_INI_SYSTEM</entry>
167
+
<entry><constant>INI_SYSTEM</constant></entry>
162
168
<entry></entry>
163
169
</row>
164
170
<row>
165
171
<entry><link linkend="ini.opcache.mmap-base">opcache.mmap_base</link></entry>
166
172
<entry>&null;</entry>
167
-
<entry>PHP_INI_SYSTEM</entry>
173
+
<entry><constant>INI_SYSTEM</constant></entry>
168
174
<entry></entry>
169
175
</row>
170
176
<row>
171
177
<entry><link linkend="ini.opcache.restrict-api">opcache.restrict_api</link></entry>
172
178
<entry>""</entry>
173
-
<entry>PHP_INI_SYSTEM</entry>
179
+
<entry><constant>INI_SYSTEM</constant></entry>
174
180
<entry></entry>
175
181
</row>
176
182
<row>
177
183
<entry><link linkend="ini.opcache.file_update_protection">opcache.file_update_protection</link></entry>
178
184
<entry>"2"</entry>
179
-
<entry>PHP_INI_ALL</entry>
185
+
<entry><constant>INI_ALL</constant></entry>
180
186
<entry></entry>
181
187
</row>
182
188
<row>
183
189
<entry><link linkend="ini.opcache.huge_code_pages">opcache.huge_code_pages</link></entry>
184
190
<entry>"0"</entry>
185
-
<entry>PHP_INI_SYSTEM</entry>
191
+
<entry><constant>INI_SYSTEM</constant></entry>
186
192
<entry></entry>
187
193
</row>
188
194
<row>
189
195
<entry><link linkend="ini.opcache.lockfile_path">opcache.lockfile_path</link></entry>
190
196
<entry>"/tmp"</entry>
191
-
<entry>PHP_INI_SYSTEM</entry>
197
+
<entry><constant>INI_SYSTEM</constant></entry>
192
198
<entry></entry>
193
199
</row>
194
200
<row>
195
201
<entry><link linkend="ini.opcache.opt_debug_level">opcache.opt_debug_level</link></entry>
196
202
<entry>"0"</entry>
197
-
<entry>PHP_INI_SYSTEM</entry>
203
+
<entry><constant>INI_SYSTEM</constant></entry>
198
204
<entry>Available as of PHP 7.1.0</entry>
199
205
</row>
200
206
<row>
201
207
<entry><link linkend="ini.opcache.file-cache">opcache.file_cache</link></entry>
202
208
<entry>NULL</entry>
203
-
<entry>PHP_INI_SYSTEM</entry>
209
+
<entry><constant>INI_SYSTEM</constant></entry>
204
210
<entry></entry>
205
211
</row>
206
212
<row>
207
213
<entry><link linkend="ini.opcache.file-cache-only">opcache.file_cache_only</link></entry>
208
214
<entry>"0"</entry>
209
-
<entry>PHP_INI_SYSTEM</entry>
215
+
<entry><constant>INI_SYSTEM</constant></entry>
210
216
<entry></entry>
211
217
</row>
212
218
<row>
213
219
<entry><link linkend="ini.opcache.file-cache-consistency-checks">opcache.file_cache_consistency_checks</link></entry>
214
220
<entry>"1"</entry>
215
-
<entry>PHP_INI_SYSTEM</entry>
221
+
<entry><constant>INI_SYSTEM</constant></entry>
216
222
<entry></entry>
217
223
</row>
218
224
<row>
219
225
<entry><link linkend="ini.opcache.file-cache-fallback">opcache.file_cache_fallback</link></entry>
220
226
<entry>"1"</entry>
221
-
<entry>PHP_INI_SYSTEM</entry>
227
+
<entry><constant>INI_SYSTEM</constant></entry>
222
228
<entry>Windows only.</entry>
223
229
</row>
224
230
<row>
225
231
<entry><link linkend="ini.opcache.validate-permission">opcache.validate_permission</link></entry>
226
232
<entry>"0"</entry>
227
-
<entry>PHP_INI_SYSTEM</entry>
233
+
<entry><constant>INI_SYSTEM</constant></entry>
228
234
<entry>Available as of PHP 7.0.14</entry>
229
235
</row>
230
236
<row>
231
237
<entry><link linkend="ini.opcache.validate-root">opcache.validate_root</link></entry>
232
238
<entry>"0"</entry>
233
-
<entry>PHP_INI_SYSTEM</entry>
239
+
<entry><constant>INI_SYSTEM</constant></entry>
234
240
<entry>Available as of PHP 7.0.14</entry>
235
241
</row>
236
242
<row>
237
243
<entry><link linkend="ini.opcache.preload">opcache.preload</link></entry>
238
244
<entry>""</entry>
239
-
<entry>PHP_INI_SYSTEM</entry>
245
+
<entry><constant>INI_SYSTEM</constant></entry>
240
246
<entry>Available as of PHP 7.4.0</entry>
241
247
</row>
242
248
<row>
243
249
<entry><link linkend="ini.opcache.preload-user">opcache.preload_user</link></entry>
244
250
<entry>""</entry>
245
-
<entry>PHP_INI_SYSTEM</entry>
251
+
<entry><constant>INI_SYSTEM</constant></entry>
246
252
<entry>Available as of PHP 7.4.0</entry>
247
253
</row>
248
254
<row>
249
255
<entry><link linkend="ini.opcache.cache-id">opcache.cache_id</link></entry>
250
-
<entry>"1"</entry>
251
-
<entry>PHP_INI_SYSTEM</entry>
256
+
<entry>""</entry>
257
+
<entry><constant>INI_SYSTEM</constant></entry>
252
258
<entry>Windows only. Available as of PHP 7.4.0</entry>
253
259
</row>
254
260
<row>
255
261
<entry><link linkend="ini.opcache.jit">opcache.jit</link></entry>
256
262
<entry>"tracing"</entry>
257
-
<entry>PHP_INI_ALL</entry>
263
+
<entry><constant>INI_ALL</constant></entry>
258
264
<entry>Available as of PHP 8.0.0</entry>
259
265
</row>
260
266
<row>
261
267
<entry><link linkend="ini.opcache.jit-buffer-size">opcache.jit_buffer_size</link></entry>
262
268
<entry>"0"</entry>
263
-
<entry>PHP_INI_SYSTEM</entry>
269
+
<entry><constant>INI_SYSTEM</constant></entry>
264
270
<entry>Available as of PHP 8.0.0</entry>
265
271
</row>
266
272
<row>
267
273
<entry><link linkend="ini.opcache.jit-debug">opcache.jit_debug</link></entry>
268
274
<entry>"0"</entry>
269
-
<entry>PHP_INI_ALL</entry>
275
+
<entry><constant>INI_ALL</constant></entry>
270
276
<entry>Available as of PHP 8.0.0</entry>
271
277
</row>
272
278
<row>
273
279
<entry><link linkend="ini.opcache.jit-bisect-limit">opcache.jit_bisect_limit</link></entry>
274
280
<entry>"0"</entry>
275
-
<entry>PHP_INI_ALL</entry>
281
+
<entry><constant>INI_ALL</constant></entry>
276
282
<entry>Available as of PHP 8.0.0</entry>
277
283
</row>
278
284
<row>
279
285
<entry><link linkend="ini.opcache.jit-prof-threshold">opcache.jit_prof_threshold</link></entry>
280
286
<entry>"0.005"</entry>
281
-
<entry>PHP_INI_ALL</entry>
287
+
<entry><constant>INI_ALL</constant></entry>
282
288
<entry>Available as of PHP 8.0.0</entry>
283
289
</row>
284
290
<row>
285
291
<entry><link linkend="ini.opcache.jit-max-root-traces">opcache.jit_max_root_traces</link></entry>
286
292
<entry>"1024"</entry>
287
-
<entry>PHP_INI_SYSTEM</entry>
293
+
<entry><constant>INI_SYSTEM</constant></entry>
288
294
<entry>Available as of PHP 8.0.0</entry>
289
295
</row>
290
296
<row>
291
297
<entry><link linkend="ini.opcache.jit-max-side-traces">opcache.jit_max_side_traces</link></entry>
292
298
<entry>"128"</entry>
293
-
<entry>PHP_INI_SYSTEM</entry>
299
+
<entry><constant>INI_SYSTEM</constant></entry>
294
300
<entry>Available as of PHP 8.0.0</entry>
295
301
</row>
296
302
<row>
297
303
<entry><link linkend="ini.opcache.jit-max-exit-counters">opcache.jit_max_exit_counters</link></entry>
298
304
<entry>"8192"</entry>
299
-
<entry>PHP_INI_SYSTEM</entry>
305
+
<entry><constant>INI_SYSTEM</constant></entry>
300
306
<entry>Available as of PHP 8.0.0</entry>
301
307
</row>
302
308
<row>
303
309
<entry><link linkend="ini.opcache.jit-hot-loop">opcache.jit_hot_loop</link></entry>
304
310
<entry>"64"</entry>
305
-
<entry>PHP_INI_SYSTEM</entry>
311
+
<entry><constant>INI_SYSTEM</constant></entry>
306
312
<entry>Available as of PHP 8.0.0</entry>
307
313
</row>
308
314
<row>
309
315
<entry><link linkend="ini.opcache.jit-hot-func">opcache.jit_hot_func</link></entry>
310
316
<entry>"127"</entry>
311
-
<entry>PHP_INI_SYSTEM</entry>
317
+
<entry><constant>INI_SYSTEM</constant></entry>
312
318
<entry>Available as of PHP 8.0.0</entry>
313
319
</row>
314
320
<row>
315
321
<entry><link linkend="ini.opcache.jit-hot-return">opcache.jit_hot_return</link></entry>
316
322
<entry>"8"</entry>
317
-
<entry>PHP_INI_SYSTEM</entry>
323
+
<entry><constant>INI_SYSTEM</constant></entry>
318
324
<entry>Available as of PHP 8.0.0</entry>
319
325
</row>
320
326
<row>
321
327
<entry><link linkend="ini.opcache.jit-hot-side-exit">opcache.jit_hot_side_exit</link></entry>
322
328
<entry>"8"</entry>
323
-
<entry>PHP_INI_SYSTEM</entry>
329
+
<entry><constant>INI_SYSTEM</constant></entry>
324
330
<entry>Available as of PHP 8.0.0</entry>
325
331
</row>
326
332
<row>
327
333
<entry><link linkend="ini.opcache.jit-blacklist-root-trace">opcache.jit_blacklist_root_trace</link></entry>
328
334
<entry>"16"</entry>
329
-
<entry>PHP_INI_ALL</entry>
335
+
<entry><constant>INI_ALL</constant></entry>
330
336
<entry>Available as of PHP 8.0.0</entry>
331
337
</row>
332
338
<row>
333
339
<entry><link linkend="ini.opcache.jit-blacklist-side-trace">opcache.jit_blacklist_side_trace</link></entry>
334
340
<entry>"8"</entry>
335
-
<entry>PHP_INI_ALL</entry>
341
+
<entry><constant>INI_ALL</constant></entry>
336
342
<entry>Available as of PHP 8.0.0</entry>
337
343
</row>
338
344
<row>
339
345
<entry><link linkend="ini.opcache.jit-max-loop-unrolls">opcache.jit_max_loop_unrolls</link></entry>
340
346
<entry>"8"</entry>
341
-
<entry>PHP_INI_ALL</entry>
347
+
<entry><constant>INI_ALL</constant></entry>
342
348
<entry>Available as of PHP 8.0.0</entry>
343
349
</row>
344
350
<row>
345
351
<entry><link linkend="ini.opcache.jit-max-recursive-calls">opcache.jit_max_recursive_calls</link></entry>
346
352
<entry>"2"</entry>
347
-
<entry>PHP_INI_ALL</entry>
353
+
<entry><constant>INI_ALL</constant></entry>
348
354
<entry>Available as of PHP 8.0.0</entry>
349
355
</row>
350
356
<row>
351
357
<entry><link linkend="ini.opcache.jit-max-recursive-return">opcache.jit_max_recursive_returns</link></entry>
352
358
<entry>"2"</entry>
353
-
<entry>PHP_INI_ALL</entry>
359
+
<entry><constant>INI_ALL</constant></entry>
354
360
<entry>Available as of PHP 8.0.0</entry>
355
361
</row>
356
362
<row>
357
363
<entry><link linkend="ini.opcache.jit-max-polymorphic-calls">opcache.jit_max_polymorphic_calls</link></entry>
358
364
<entry>"2"</entry>
359
-
<entry>PHP_INI_ALL</entry>
365
+
<entry><constant>INI_ALL</constant></entry>
360
366
<entry>Available as of PHP 8.0.0</entry>
361
367
</row>
362
368
</tbody>
...
...
@@ -476,6 +482,14 @@
476
482
manually via <function>opcache_reset</function>,
477
483
<function>opcache_invalidate</function> or by restarting the Web server
478
484
for changes to the filesystem to take effect.
485
+
<note>
486
+
<simpara>
487
+
OPcache may still validate the timestamp of a file at compile-time if
488
+
<link linkend="ini.opcache.file_update_protection">opcache.file_update_protection</link>
489
+
or <link linkend="ini.opcache.max-file-size">opcache.max_file_size</link>
490
+
options are set to non-zero values.
491
+
</simpara>
492
+
</note>
479
493
</para>
480
494
</listitem>
481
495
</varlistentry>
...
...
@@ -570,6 +584,9 @@
570
584
<listitem>
571
585
<para>
572
586
A bitmask that controls which optimisation passes are executed.
587
+
The default is to apply all safe optimizations.
588
+
Changing the default is mostly useful for debugging/developing the optimizer
589
+
(see also <link linkend="ini.opcache.opt_debug_level">opcache.opt_debug_level</link>).
573
590
</para>
574
591
</listitem>
575
592
</varlistentry>
...
...
@@ -648,6 +665,11 @@
648
665
where N is the value of this configuration directive. This should only
649
666
be enabled when debugging, as it will impair performance.
650
667
</para>
668
+
<note>
669
+
<para>
670
+
Disabled as of 8.1.18 and 8.2.5. Removed as of PHP 8.3.0.
671
+
</para>
672
+
</note>
651
673
</listitem>
652
674
</varlistentry>
653
675
<varlistentry xml:id="ini.opcache.force-restart-timeout">
...
...
@@ -699,6 +721,18 @@
699
721
</para>
700
722
</listitem>
701
723
</varlistentry>
724
+
<varlistentry xml:id="ini.opcache.record-warnings">
725
+
<term>
726
+
<parameter>opcache.record_warnings</parameter>
727
+
<type>bool</type>
728
+
</term>
729
+
<listitem>
730
+
<para>
731
+
If enabled, OPcache will record compile-time warnings and replay them on
732
+
the next include, even if it is served from cache.
733
+
</para>
734
+
</listitem>
735
+
</varlistentry>
702
736
<varlistentry xml:id="ini.opcache.preferred-memory-model">
703
737
<term>
704
738
<parameter>opcache.preferred_memory_model</parameter>
...
...
@@ -763,7 +797,8 @@
763
797
<para>
764
798
Prevents caching files that are less than this number of seconds old.
765
799
It protects from caching of incompletely updated files. In case all file
766
-
updates on your site are atomic, you may increase performance by setting it to "0".
800
+
updates are atomic, performance can be increased by setting this to <literal>0</literal>.
801
+
This will allow files to be cached immediately.
767
802
</para>
768
803
</listitem>
769
804
</varlistentry>
...
...
@@ -826,6 +861,12 @@
826
861
<para>
827
862
Enables or disables opcode caching in shared memory.
828
863
</para>
864
+
<note>
865
+
<para>
866
+
Prior to PHP 8.1.0, disabling this directive with an already populated
867
+
file cache required to manually clear the file cache.
868
+
</para>
869
+
</note>
829
870
</listitem>
830
871
</varlistentry>
831
872
<varlistentry xml:id="ini.opcache.file-cache-consistency-checks">
...
...
@@ -908,8 +949,10 @@
908
949
</term>
909
950
<listitem>
910
951
<para>
911
-
Preloading code as root is not allowed for security reasons. This directive
912
-
facilitates to let the preloading to be run as another user.
952
+
Lets the preloading to be run as the specified system user. This is useful for servers that
953
+
startup as root before switching to an unprivileged system user. Preloading as root is not
954
+
allowed by default for security reasons, unless this directive is explicitly set to
955
+
<literal>root</literal>.
913
956
</para>
914
957
</listitem>
915
958
</varlistentry>
...
...
@@ -924,6 +967,13 @@
924
967
under the same user account having the same cache ID share a single OPcache instance.
925
968
The value of the cache ID can be freely chosen.
926
969
</para>
970
+
<tip>
971
+
<simpara>
972
+
For IIS, different application pools can have their own OPcache instance
973
+
by using the environment variable <envar>APP_POOL_ID</envar> as
974
+
<parameter>opcache.cache_id</parameter>.
975
+
</simpara>
976
+
</tip>
927
977
</listitem>
928
978
</varlistentry>
929
979
<varlistentry xml:id="ini.opcache.jit">
...
...
@@ -1024,7 +1074,9 @@
1024
1074
<listitem>
1025
1075
<para>
1026
1076
A bit mask specifying which JIT debug output to enable.
1027
-
For possible values, please consult <filename>zend_jit.h</filename>.
1077
+
For possible values, please consult
1078
+
<link xlink:href="&url.php.git.src.master.view;ext/opcache/jit/zend_jit.h">zend_jit.h</link>
1079
+
(search for macro definitions beginning with <code>ZEND_JIT_DEBUG</code>).
1028
1080
</para>
1029
1081
</listitem>
1030
1082
</varlistentry>
...
...
@@ -1036,7 +1088,9 @@
1036
1088
<listitem>
1037
1089
<para>
1038
1090
Debugging option that disables JIT compilation after compiling a certain number of functions.
1039
-
This may be helpful to bisect the source of a JIT miscompilation.
1091
+
This may be helpful to bisect the source of a JIT miscompilation. Note: this option only works
1092
+
when JIT trigger is set to 0 (compile on script load) or 1 (compile on first execution),
1093
+
e.g., <code>opcache.jit=1215</code>. See more in <link linkend="ini.opcache.jit">opcache.jit</link> option.
1040
1094
</para>
1041
1095
</listitem>
1042
1096
</varlistentry>
...
...
@@ -1061,7 +1115,8 @@
1061
1115
</term>
1062
1116
<listitem>
1063
1117
<para>
1064
-
Maximum number of root traces.
1118
+
Maximum number of root traces. The root trace is an execution flow taking one path through the code firstly,
1119
+
which is a unit of JIT compilation. JIT will not compile new code if it reaches this limit.
1065
1120
</para>
1066
1121
</listitem>
1067
1122
</varlistentry>
...
...
@@ -1072,7 +1127,9 @@
1072
1127
</term>
1073
1128
<listitem>
1074
1129
<para>
1075
-
Maximum number of side traces a root trace may have.
1130
+
Maximum number of side traces a root trace may have. The side trace is another execution flow that does not
1131
+
follow the path of compiled root trace. Side traces belonging to the same root trace will not be compiled
1132
+
if it reaches this limit.
1076
1133
</para>
1077
1134
</listitem>
1078
1135
</varlistentry>
...
...
@@ -1096,6 +1153,9 @@
1096
1153
<listitem>
1097
1154
<para>
1098
1155
After how many iterations a loop is considered hot.
1156
+
Valid value range is <code>[0,255]</code>; for any setting out of this range,
1157
+
e.g., -1 or 256, default value will be used instead. Specially, a zero value
1158
+
will disable JIT to trace and compile any loops.
1099
1159
</para>
1100
1160
</listitem>
1101
1161
</varlistentry>
...
...
@@ -1107,6 +1167,9 @@
1107
1167
<listitem>
1108
1168
<para>
1109
1169
After how many calls a function is considered hot.
1170
+
Valid value range is <code>[0,255]</code>; for any setting out of this range,
1171
+
e.g., -1 or 256, default value will be used instead. Specially, a zero value
1172
+
will disable JIT to trace and compile any functions.
1110
1173
</para>
1111
1174
</listitem>
1112
1175
</varlistentry>
...
...
@@ -1118,6 +1181,9 @@
1118
1181
<listitem>
1119
1182
<para>
1120
1183
After how many returns a return is considered hot.
1184
+
Valid value range is <code>[0,255]</code>; for any setting out of this range,
1185
+
e.g., -1 or 256, default value will be used instead. Specially, a zero value
1186
+
will disable JIT to trace and compile any returns.
1121
1187
</para>
1122
1188
</listitem>
1123
1189
</varlistentry>
...
...
@@ -1129,6 +1195,9 @@
1129
1195
<listitem>
1130
1196
<para>
1131
1197
After how many exits a side exit is considered hot.
1198
+
Valid value range is <code>[0,255]</code>; for any setting out of this range,
1199
+
e.g., -1 or 256, default value will be used instead. Specially, a zero value
1200
+
will disable JIT to trace and compile any side exits.
1132
1201
</para>
1133
1202
</listitem>
1134
1203
</varlistentry>
1135
1204



Tools (Spanish Manual)