reference/outcontrol/ini.xml
d4d5216e7a965ca194f6b1c9dee84cecab2674e5
d4d5216e7a965ca194f6b1c9dee84cecab2674e5
...
...
@@ -18,34 +18,37 @@
18
18
<tbody>
19
19
<row>
20
20
<entry><link linkend="ini.output-buffering">output_buffering</link></entry>
21
-
<entry>"0"</entry>
22
-
<entry>PHP_INI_PERDIR</entry>
21
+
<entry><literal>"0"</literal></entry>
22
+
<entry><constant>INI_PERDIR</constant></entry>
23
23
<entry></entry>
24
24
</row>
25
25
<row>
26
26
<entry><link linkend="ini.output-handler">output_handler</link></entry>
27
-
<entry>NULL</entry>
28
-
<entry>PHP_INI_PERDIR</entry>
27
+
<entry>&null;</entry>
28
+
<entry><constant>INI_PERDIR</constant></entry>
29
29
<entry></entry>
30
30
</row>
31
31
<row>
32
32
<entry><link linkend="ini.implicit-flush">implicit_flush</link></entry>
33
-
<entry>"0"</entry>
34
-
<entry>PHP_INI_ALL</entry>
33
+
<entry><literal>"0"</literal></entry>
34
+
<entry><constant>INI_ALL</constant></entry>
35
35
<entry></entry>
36
36
</row>
37
37
<row>
38
38
<entry><link linkend="ini.url-rewriter.tags">url_rewriter.tags</link></entry>
39
-
<entry>"a=href,area=href,frame=src,form=,fieldset="</entry>
40
-
<entry>PHP_INI_ALL</entry>
41
-
<entry>Before PHP 7.1.0, this was used to set
42
-
session's trans sid rewrite. From PHP 7.1.0, it is only used by
43
-
<function>output_add_rewrite_var</function>.</entry>
39
+
<entry><literal>"form="</literal></entry>
40
+
<entry><constant>INI_ALL</constant></entry>
41
+
<entry>
42
+
As of PHP 7.1.0, this INI setting only affects
43
+
<function>output_add_rewrite_var</function>.
44
+
Prior to PHP 7.1.0, this INI setting enabled transparent session id support
45
+
(see <link linkend="ini.session.trans-sid-tags">session.trans_sid_tags</link>).
46
+
</entry>
44
47
</row>
45
48
<row>
46
49
<entry><link linkend="ini.url-rewriter.hosts">url_rewriter.hosts</link></entry>
47
50
<entry><literal>$_SERVER['HTTP_HOST']</literal> is used as default.</entry>
48
-
<entry>PHP_INI_ALL</entry>
51
+
<entry><constant>INI_ALL</constant></entry>
49
52
<entry>Available as of PHP 7.1.0</entry>
50
53
</row>
51
54
</tbody>
...
...
@@ -65,10 +68,12 @@
65
68
</term>
66
69
<listitem>
67
70
<para>
68
-
You can enable output buffering for all files by setting this directive
69
-
to 'On'. If you wish to limit the size of the buffer to a certain size -
70
-
you can use a maximum number of bytes instead of 'On', as a value for
71
-
this directive (e.g., output_buffering=4096).
71
+
Output buffering for all files can be enabled by setting this directive
72
+
to <literal>"On"</literal>.
73
+
To limit the size of the buffer, a number/quantity corresponding to the
74
+
maximum numbers of bytes allowed can be used instead of
75
+
<literal>"On"</literal> for the value of this directive.
76
+
For example <literal>output_buffering=4096</literal>.
72
77
This directive is always Off in PHP-CLI.
73
78
</para>
74
79
</listitem>
...
...
@@ -81,24 +86,31 @@
81
86
</term>
82
87
<listitem>
83
88
<para>
84
-
You can redirect all of the output of your scripts to a function. For
85
-
example, if you set output_handler to
86
-
<function>mb_output_handler</function>, character encoding will be
87
-
transparently converted to the specified encoding. Setting any output
88
-
handler automatically turns on output buffering.
89
+
The output of scripts can be redirected to a function.
90
+
For example setting <literal>output_handler</literal>
91
+
to <function>mb_output_handler</function>, character encoding will be
92
+
transparently converted to the specified encoding.
93
+
Setting any output handler automatically turns on output buffering.
89
94
</para>
90
95
<note>
91
96
<para>
92
-
You cannot use both <function>mb_output_handler</function> with
93
-
<function>ob_iconv_handler</function> and you cannot use both
94
-
<function>ob_gzhandler</function> and
95
-
<link linkend="ini.zlib.output-compression">zlib.output_compression</link>.
97
+
<function>mb_output_handler</function> and
98
+
<function>ob_iconv_handler</function> cannot be used together
99
+
and <function>ob_gzhandler</function> and
100
+
<link linkend="ini.zlib.output-compression">zlib.output_compression</link>
101
+
cannot be used with any of the following:
102
+
<function>mb_output_handler</function>,
103
+
<function>ob_gzhandler</function>,
104
+
<link linkend="ini.zlib.output-compression">zlib.output_compression</link>,
105
+
the 'URL-Rewriter' handler
106
+
(see <link linkend="ini.session.use-trans-sid">session.use_trans_sid</link>
107
+
and <function>output_add_rewrite_var</function>).
96
108
</para>
97
109
</note>
98
110
<note>
99
111
<para>
100
-
Only built-in functions can be used with this directive. For user
101
-
defined functions, use <function>ob_start</function>.
112
+
Only built-in functions can be used with this directive.
113
+
For user defined functions, use <function>ob_start</function>.
102
114
</para>
103
115
</note>
104
116
</listitem>
...
...
@@ -115,8 +127,9 @@
115
127
output layer to flush itself automatically after every output block.
116
128
This is equivalent to calling the PHP function
117
129
<function>flush</function> after each and every call to
118
-
<function>print</function> or <function>echo</function> and each and
119
-
every <literal>HTML</literal> block.
130
+
any function producing output (such as
131
+
<function>print</function> or <function>echo</function>)
132
+
and each and every HTML block.
120
133
</para>
121
134
<para>
122
135
When using PHP within an web environment, turning
...
...
@@ -137,20 +150,26 @@
137
150
</term>
138
151
<listitem>
139
152
<simpara>
140
-
<literal>url_rewriter.tags</literal> specifies which HTML tags
141
-
are rewritten by <function>output_add_rewrite_var</function> values.
142
-
Defaults to
143
-
<literal>a=href,area=href,frame=src,input=src,form=</literal>
153
+
<literal>url_rewriter.tags</literal> specifies HTML tags and attributes
154
+
in which URLs are rewritten by <function>output_add_rewrite_var</function> values.
155
+
Defaults to <literal>"form="</literal>.
144
156
</simpara>
145
157
<simpara>
146
-
<literal>form</literal> is special tag. <literal><input hidden="session_id" name="session_name"></literal>
147
-
is added as form variable.
158
+
Adding <literal>"form="</literal> or any <literal>form</literal> attribute
159
+
will add a hidden <literal>input</literal> element to the <literal>form</literal>
160
+
with a name and value attribute for each name-value pair passed to
161
+
<function>output_add_rewrite_var</function>.
148
162
</simpara>
163
+
<caution>
164
+
<simpara>
165
+
Adding the same tag more than once to <literal>url_rewriter.tags</literal>
166
+
will only use the first occurence during the URL rewriting process.
167
+
</simpara>
168
+
</caution>
149
169
<note>
150
170
<simpara>
151
-
Before PHP 7.1.0, <link linkend="ini.url-rewriter.tags">url_rewriter.tags</link>
171
+
Prior to PHP 7.1.0, <link linkend="ini.url-rewriter.tags">url_rewriter.tags</link>
152
172
was used to specify <link linkend="ini.session.trans-sid-tags">session.trans_sid_tags</link>.
153
-
As of PHP 7.1.0, <literal>fieldset</literal> is no longer considered as special tag.
154
173
</simpara>
155
174
</note>
156
175
</listitem>
...
...
@@ -165,9 +184,10 @@
165
184
<simpara>
166
185
<literal>url_rewriter.hosts</literal> specifies which hosts are
167
186
rewritten to include <function>output_add_rewrite_var</function> values.
168
-
Defaults to <literal>$_SERVER['HTTP_HOST']</literal>. Multiple hosts
169
-
can be specified by ",", no space is allowed between hosts. e.g.
170
-
<literal>php.net,wiki.php.net,bugs.php.net</literal>
187
+
Defaults to <literal>$_SERVER['HTTP_HOST']</literal>.
188
+
Multiple hosts can be specified by a comma separated list
189
+
that does not include spaces.
190
+
For example <literal>"php.net,wiki.php.net,bugs.php.net"</literal>.
171
191
</simpara>
172
192
</listitem>
173
193
</varlistentry>
174
194