ini.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 occurence 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
-->