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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: julionc -->

<section xml:id="phar.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Opciones de Configuración de Flujos y Sistema de Ficheros</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>
      Esta opción deshabilita la modificación o creación de archivos Phar
      usando el flujo <literal>phar</literal> o el soporte para escritura de
      objetos <classname>Phar</classname>. Este ajuste debería estar siempre activado en
      máquinas de producción, ya que el soporte para escritura conveniente de la extensión phar
      podría permitir la simple creación de un virus basado en PHP al asociarse
      con otras vulnerabilidades de seguridad comunes.
     </para>
     <note>
      <para>
       Este ajuste sólo puede ser desactivado en php.ini por motivos de seguridad.
       Si <literal>phar.readonly</literal> está deshabilitado en php.ini, un
       usuario puede habilitar <literal>phar.readonly</literal> en un script
       o deshabilitarlo después. Si <literal>phar.readonly</literal> está
       habilitado en php.ini, un scrip puede &quot;re-habilitar&quot; inofensivamente
       la variable INI, pero no puede deshabilitarla.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.phar.require-hash">
    <term>
     <parameter>phar.require_hash</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Esta opción forzará a todos los archivos Phar abiertos a que contengan algún
      tipo de signatura (actualmente está soportadas MD5, SHA1, SHA256 y SHA512), y
      rehusará procesar cualquer archivo Phar que no contenga una signatura.
     </para>
     <note>
      <para>
       Este ajuste sólo puede ser desactivado en php.ini por motivos de seguridad.
       Si <literal>phar.require_hash</literal> está deshabilitado en php.ini, un
       usuario puede habilitar <literal>phar.require_hash</literal> en un script
       o deshabilitarlo después. Si <literal>phar.require_hash</literal> está
       habilitado en php.ini, un scrip puede &quot;re-habilitar&quot; inofensivamente
       la variable INI, pero no puede deshabilitarla.
      </para>
      <para>
       Este ajuste no afecta a la lectura de ficheros tar planos con la
       clase <classname>PharData</classname>.
      </para>
     </note>
     <caution>
      <simpara>
       <literal>phar.require_hash</literal> no proporciona ninguna seguridad per se,
       es simplemente una medida contra la ejecución accidental de archivos Phar corruptos,
       porque cualquiera que pueda alterar el Phar podría corregir fácilmente la firma.
      </simpara>
     </caution>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.phar.cache-list">
    <term>
     <parameter>phar.cache_list</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Permite mapear archivos phar para que sean preanalizados en el arranque del servidor web,
      proporcionando una mejora de rendimiento que saca ficheros en ejecución de un
      archivo phar casi tan rápido como si esos ficheros se ejecutaran desde una
      instalación tradicional basada en disco.
      <example>
       <title>Ejemplo de uso de phar.cache_list</title>
       <programlisting>
<![CDATA[
en php.ini (windows):
phar.cache_list =C:\ruta\a\phar1.phar;C:\ruta\a\phar2.phar
en php.ini (unix):
phar.cache_list =/ruta/a/phar1.phar:/ruta/a/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
-->