archived-doc-ja/reference/phar/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6dfe0767250cdbdf509223f6bc266557b0a3fec9 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<section xml:id="phar.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 xml:id="phar.configuration.list">
     <row>
      <entry><link linkend="ini.phar.readonly">phar.readonly</link></entry>
      <entry>"1"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.require-hash">phar.require_hash</link></entry>
      <entry>"1"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.cache-list">phar.cache_list</link></entry>
      <entry>""</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
 
 &ini.descriptions.title;
 
 <para>
  <variablelist>
   <varlistentry xml:id="ini.phar.readonly">
    <term>
     <parameter>phar.readonly</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      このオプションを使用すると、<literal>phar</literal>
      ストリームや <classname>Phar</classname>
      オブジェクトによる Phar アーカイブの作成や変更ができなくなります。
      この設定は、実運用環境では常に有効にしておくべきです。
      phar 拡張モジュールのこの機能は、
      サーバー上に他のセキュリティ上の脆弱性があった場合に
      php ベースのウィルスを直接作成されてしまうことにつながります。
     </para>
     <note>
      <para>
       この設定は、php.ini でしか解除できません。
       <literal>phar.readonly</literal> を php.ini で無効にした場合は、
       ユーザーがスクリプト内で <literal>phar.readonly</literal>
       の有効/無効を切りかえることができます。
       <literal>phar.readonly</literal> を php.ini で有効にした場合は、
       スクリプト内でこれを &quot;再度有効にする&quot;
       ことはできますが、無効にすることはできません。
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.phar.require-hash">
    <term>
     <parameter>phar.require_hash</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      このオプションを使用すると、署名つき
      (現在サポートしているのは MD5、SHA1、SHA256、SHA512、および OpenSSL)
      の Phar アーカイブのみをオープンするようになります。
      署名を含まない Phar アーカイブの処理はできません。
     </para>
     <note>
      <para>
       この設定は、セキュリティ上の理由により
       php.ini でしか解除できません。
       <literal>phar.require_hash</literal> を php.ini で無効にした場合は、
       ユーザーがスクリプト内で <literal>phar.require_hash</literal>
       の有効/無効を切りかえることができます。
       <literal>phar.require_hash</literal> を php.ini で有効にした場合は、
       スクリプト内でこれを &quot;再度有効にする&quot;
       ことはできますが、無効にすることはできません。
      </para>
      <para>
       この設定は、
       <classname>PharData</classname> クラスで通常の
       tar ファイルを読み込む際には影響を及ぼしません。
      </para>
     </note>
     <caution>
      <simpara>
       <literal>phar.require_hash</literal> は、それ自体はセキュリティ上の機能を提供しません。
       壊れた Pharアーカイブを誤って実行することへの備えでしかありません。
       Phar を改ざんできる人は、シグネチャを後で簡単に修正できてしまうからです。
      </simpara>
     </caution>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.phar.cache-list">
    <term>
     <parameter>phar.cache_list</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      phar アーカイブをウェブサーバーの起動時に事前にパースさせるようにします。
      これによりパフォーマンスが向上し、
      ディスク上に配置した伝統的なファイルに近い速度で実行することができます。
      <example>
       <title>phar.cache_list の使用例</title>
       <programlisting>
<![CDATA[
php.ini (windows):
phar.cache_list =C:\path\to\phar1.phar;C:\path\to\phar2.phar
php.ini (unix):
phar.cache_list =/path/to/phar1.phar:/path/to/phar2.phar
]]>
       </programlisting>
      </example>
     </para>
    </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
-->