mirror of
https://github.com/php/doc-en.git
synced 2026-04-29 10:13:23 +02:00
Louis-Arnaud
219 lines
7.1 KiB
XML
219 lines
7.1 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<section xml:id="outcontrol.configuration" xmlns="http://docbook.org/ns/docbook">
|
|
&reftitle.runtime;
|
|
&extension.runtime;
|
|
<para>
|
|
<table>
|
|
<title>Output Control configuration options</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>
|
|
As of PHP 7.1.0, this INI setting only affects
|
|
<function>output_add_rewrite_var</function>.
|
|
Prior to PHP 7.1.0, this INI setting enabled transparent session id support
|
|
(see <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> is used as default.</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry>Available as of 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>
|
|
Output buffering for all files can be enabled by setting this directive
|
|
to <literal>"On"</literal>.
|
|
To limit the size of the buffer, a number/quantity corresponding to the
|
|
maximum numbers of bytes allowed can be used instead of
|
|
<literal>"On"</literal> for the value of this directive.
|
|
For example <literal>output_buffering=4096</literal>.
|
|
This directive is always Off in PHP-CLI.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.output-handler">
|
|
<term>
|
|
<parameter>output_handler</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
The output of scripts can be redirected to a function.
|
|
For example setting <literal>output_handler</literal>
|
|
to <function>mb_output_handler</function>, character encoding will be
|
|
transparently converted to the specified encoding.
|
|
Setting any output handler automatically turns on output buffering.
|
|
</para>
|
|
<note>
|
|
<para>
|
|
<function>mb_output_handler</function> and
|
|
<function>ob_iconv_handler</function> cannot be used together
|
|
and <function>ob_gzhandler</function> and
|
|
<link linkend="ini.zlib.output-compression">zlib.output_compression</link>
|
|
cannot be used with any of the following:
|
|
<function>mb_output_handler</function>,
|
|
<function>ob_gzhandler</function>,
|
|
<link linkend="ini.zlib.output-compression">zlib.output_compression</link>,
|
|
the 'URL-Rewriter' handler
|
|
(see <link linkend="ini.session.use-trans-sid">session.use_trans_sid</link>
|
|
and <function>output_add_rewrite_var</function>).
|
|
</para>
|
|
</note>
|
|
<note>
|
|
<para>
|
|
Only built-in functions can be used with this directive.
|
|
For user defined functions, use <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; by default. Changing this to &true; tells PHP to tell the
|
|
output layer to flush itself automatically after every output block.
|
|
This is equivalent to calling the PHP function
|
|
<function>flush</function> after each and every call to
|
|
any function producing output (such as
|
|
<function>print</function> or <function>echo</function>)
|
|
and each and every HTML block.
|
|
</para>
|
|
<para>
|
|
When using PHP within an web environment, turning
|
|
this option on has serious performance implications and is generally
|
|
recommended for debugging purposes only. This value defaults to
|
|
&true; when operating under the <literal>CLI SAPI</literal>.
|
|
</para>
|
|
<para>
|
|
See also <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> specifies HTML tags and attributes
|
|
in which URLs are rewritten by <function>output_add_rewrite_var</function> values.
|
|
Defaults to <literal>"form="</literal>.
|
|
</simpara>
|
|
<simpara>
|
|
Adding <literal>"form="</literal> or any <literal>form</literal> attribute
|
|
will add a hidden <literal>input</literal> element to the <literal>form</literal>
|
|
with a name and value attribute for each name-value pair passed to
|
|
<function>output_add_rewrite_var</function>.
|
|
</simpara>
|
|
<caution>
|
|
<simpara>
|
|
Adding the same tag more than once to <literal>url_rewriter.tags</literal>
|
|
will only use the first occurrence during the URL rewriting process.
|
|
</simpara>
|
|
</caution>
|
|
<note>
|
|
<simpara>
|
|
Prior to PHP 7.1.0, <link linkend="ini.url-rewriter.tags">url_rewriter.tags</link>
|
|
was used to specify <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> specifies which hosts are
|
|
rewritten to include <function>output_add_rewrite_var</function> values.
|
|
Defaults to <literal>$_SERVER['HTTP_HOST']</literal>.
|
|
Multiple hosts can be specified by a comma separated list
|
|
that does not include spaces.
|
|
For example <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
|
|
-->
|