-
Notifications
You must be signed in to change notification settings - Fork 104
/
ini.xml
190 lines (182 loc) · 6.78 KB
/
ini.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: HonestQiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<section xml:id="outcontrol.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>输出控制配置选项</title>
<tgroup cols="4">
<thead>
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend="ini.output-buffering">output_buffering</link></entry>
<entry><literal>"0"</literal></entry>
<entry><constant>INI_PERDIR</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.output-handler">output_handler</link></entry>
<entry>&null;</entry>
<entry><constant>INI_PERDIR</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.implicit-flush">implicit_flush</link></entry>
<entry><literal>"0"</literal></entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.url-rewriter.tags">url_rewriter.tags</link></entry>
<entry><literal>"form="</literal></entry>
<entry><constant>INI_ALL</constant></entry>
<entry>从 PHP 7.1.0 起,此 INI 设置仅影响 <function>output_add_rewrite_var</function>。在 PHP 7.1.0
之前,此 INI 设置启用透明会话 id 支持(请参阅 <link
linkend="ini.session.trans-sid-tags">session.trans_sid_tags</link>)。</entry>
</row>
<row>
<entry><link linkend="ini.url-rewriter.hosts">url_rewriter.hosts</link></entry>
<entry><literal>$_SERVER['HTTP_HOST']</literal> 用作默认值。</entry>
<entry><constant>INI_ALL</constant></entry>
<entry>自 PHP 7.1.0 起可用</entry>
</row>
</tbody>
</tgroup>
</table>
&ini.php.constants;
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.output-buffering">
<term>
<parameter>output_buffering</parameter>
<type>bool</type>/<type>int</type>
</term>
<listitem>
<para>
通过设置该选项为 <literal>"On"</literal>,来启用所有文件的输出缓冲。如果要限制缓冲区的大小,可以使用允许的最大字节数相对应的数字/数量来代替该指令的值
<literal>"On"</literal>。例如 <literal>output_buffering=4096</literal>。该选项在 PHP-CLI 下始终关闭。
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.output-handler">
<term>
<parameter>output_handler</parameter>
<type>string</type>
</term>
<listitem>
<para>
脚本的输出可以重定向到函数。例如设置 <literal>output_handler</literal> 为 <function>mb_output_handler</function>
时,字符编码将会明确转换为指定编码。设置任何输出处理程序都会自动打开输出缓冲。
</para>
<note>
<para>
<function>mb_output_handler</function> 和 <function>ob_iconv_handler</function> 不能一起使用,并且 <function>ob_gzhandler</function> 和
<link linkend="ini.zlib.output-compression">zlib.output_compression</link> 不能与以下函数一起使用
<function>mb_output_handler</function>、<function>ob_gzhandler</function>、<link linkend="ini.zlib.output-compression">zlib.output_compression</link>、“URL
重写器”处理程序(请参阅 <link linkend="ini.session.use-trans-sid">session.use_trans_sid</link> 和 <function>output_add_rewrite_var</function>)。
</para>
</note>
<note>
<para>
只有内置函数可以使用此指令。对于用户定义的函数,使用 <function>ob_start</function>。
</para>
</note>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.implicit-flush">
<term>
<parameter>implicit_flush</parameter>
<type>bool</type>
</term>
<listitem>
<para>
默认为 &false;。如将该选项改为 &true;,PHP
将使输出层在每段信息块输出后自动刷新。这等同于在每次调用任何产出输出的函数(比如
<function>print</function>、<function>echo</function>)以及每个
HTML 块之后,调用 PHP 函数 <function>flush</function>。
</para>
<para>
在 Web 环境中使用 PHP 时,打开这个选项会严重影响性能,通常只推荐在调试时使用。在
<literal>CLI SAPI</literal> 操作时,此值默认为 &true;。
</para>
<para>
参见 <function>ob_implicit_flush</function>。
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.url-rewriter.tags">
<term>
<parameter>url_rewriter.tags</parameter>
<type>string</type>
</term>
<listitem>
<simpara>
<literal>url_rewriter.tags</literal> 指定 HTML 标记和属性,其中 URL 由 <function>output_add_rewrite_var</function>
值重写。默认为 <literal>"form="</literal>。
</simpara>
<simpara>
添加 <literal>"form="</literal> 或任何 <literal>form</literal> 属性将向 <literal>form</literal> 添加隐藏的 <literal>input</literal>
元素,并为传递给 <function>output_add_rewrite_var</function> 的每个名值对(name-value pair)添加名和值属性。
</simpara>
<caution>
<simpara>
在 <literal>url_rewriter.tags</literal> 中多次添加相同的标签将仅在 URL 重写过程中使用第一次出现的标签。
</simpara>
</caution>
<note>
<simpara>
PHP 7.1.0 之前,使用 <link linkend="ini.url-rewriter.tags">url_rewriter.tags</link> 指定
<link linkend="ini.session.trans-sid-tags">session.trans_sid_tags</link>。
</simpara>
</note>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.url-rewriter.hosts">
<term>
<parameter>url_rewriter.hosts</parameter>
<type>string</type>
</term>
<listitem>
<simpara>
<literal>url_rewriter.hosts</literal> 可以指定重写那些主机包含
<function>output_add_rewrite_var</function> 值。默认是
<literal>$_SERVER['HTTP_HOST']</literal>。通过不包含空格的逗号分隔列表指定多个主机。例如
<literal>"php.net,wiki.php.net,bugs.php.net"</literal>。
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->