<?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>"0"</entry>
     <entry>PHP_INI_PERDIR</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.output-handler">output_handler</link></entry>
     <entry>NULL</entry>
     <entry>PHP_INI_PERDIR</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.implicit-flush">implicit_flush</link></entry>
     <entry>"0"</entry>
     <entry>PHP_INI_ALL</entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.url-rewriter.tags">url_rewriter.tags</link></entry>
     <entry>"a=href,area=href,frame=src,form=,fieldset="</entry>
     <entry>PHP_INI_ALL</entry>
     <entry>Before PHP 7.1.0, this was used to set
     session's trans sid rewrite. From PHP 7.1.0, it is only used by 
     <function>output_add_rewrite_var</function>.</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>PHP_INI_ALL</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>
     You can enable output buffering for all files by setting this directive
     to 'On'. If you wish to limit the size of the buffer to a certain size -
     you can use a maximum number of bytes instead of 'On', as a value for
     this directive (e.g., output_buffering=4096).
     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>
     You can redirect all of the output of your scripts to a function. For
     example, if you set output_handler 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>
      You cannot use both <function>mb_output_handler</function> with
      <function>ob_iconv_handler</function> and you cannot use both
      <function>ob_gzhandler</function> and
      <link linkend="ini.zlib.output-compression">zlib.output_compression</link>.
     </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
     <function>print</function> or <function>echo</function> and each and
     every <literal>HTML</literal> 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 which HTML tags
     are rewritten by <function>output_add_rewrite_var</function> values.
     Defaults to
     <literal>a=href,area=href,frame=src,input=src,form=</literal>
    </simpara>
    <simpara>
     <literal>form</literal> is special tag. <literal>&lt;input hidden="session_id" name="session_name"&gt;</literal>
     is added as form variable.
    </simpara>
    <note>
     <simpara>
      Before 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>.
      As of PHP 7.1.0, <literal>fieldset</literal> is no longer considered as special tag.
     </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 ",", no space is allowed between hosts. e.g.
     <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
-->
