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

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6dfe0767250cdbdf509223f6bc266557b0a3fec9 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->

<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>
      Этот параметр отключает поддержку создания или модификации Phar-архивов
      с помощью потока <literal>phar</literal> и записи объектов <classname>Phar</classname> на диск.
      Этот параметр всегда должен быть включён на рабочих машинах,
      поскольку поддержка записи модулем 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; переменную INI, но не может отключить её.
      </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; переменную INI, но не может отключить её.
      </para>
      <para>
       Этот параметр не влияет на чтение простых tar-файлов
       при помощи класса <classname>PharData</classname>.
      </para>
     </note>
     <caution>
      <simpara>
       <literal>phar.require_hash</literal> не обеспечивает безопасности как таковой -
       это всего лишь мера по защите от запуска повреждённого 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-архивов, для которых необходимо
      осуществить предварительный разбор в момент старта веб-сервера.
      Обеспечивает повышение производительности за счёт запуска файлов вне
      phar-архива со скоростью, очень близкой к той, которая была бы при запуске
      этих файлов традиционным способом с диска.
      <example>
       <title>Пример использования phar.cache_list</title>
       <programlisting>
<![CDATA[
в php.ini (windows):
phar.cache_list =C:\путь\к\phar1.phar;C:\путь\к\phar2.phar
в php.ini (unix):
phar.cache_list =/путь/к/phar1.phar:/путь/к/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
-->