ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c2c5f47c53f58b5a50b5cc3c30116cb2aecf2d3c Maintainer: hirokawa Status: ready -->
<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 ではこのディレクティブが常に Off となります。
    </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> を指定した場合、
      文字エンコーディングは透過的に指定したエンコーディングに
      変換されます。出力ハンドラを指定することにより自動的に出力
      バッファリングが on になります。
     </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-Rewriter' ハンドラ
       (<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> のような)
      出力を生成するあらゆる関数をコールするたびに/コールし、
      <literal>HTML</literal> ブロックの後で
      <function>flush</function> 関数をコールすることと等価です。
    </para>
     <para>
      Web 環境の中で PHP を使用している時に
      このオプションを on に変更すると、著しい性能低下が生じるため、
      通常はデバッグ目的のみにすることが推奨されます。<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> は、
     <function>output_add_rewrite_var</function>
     の値でどのURLのHTMLタグや属性を書き換えるかを指定します。
     デフォルトは <literal>"form="</literal> です。
    </simpara>
    <simpara>
     <literal>"form="</literal> や <literal>form</literal>
     の任意の属性を追加すると、
     <literal>input</literal> 要素の hidden 要素が
     <function>output_add_rewrite_var</function> に渡された name/value
     のペアごとに <literal>form</literal>要素に追加されます。
    </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> のを指定するために使われていました。
      PHP 7.1.0 以降は、<literal>fieldset</literal> は特別なタグとはみなされなくなります。
     </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
-->