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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f052ac1bd73549125c3fc3dc68a36d4b0608a16d Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->

<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>
     <row>
      <entry><link linkend="ini.phar.readonly">phar.readonly</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.require-hash">phar.require_hash</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.extract-list">phar.extract_list</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde phar 1.1.0 a 1.2.3, eliminado en 2.0.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.cache-list">phar.cache_list</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Disponible desde phar 2.0.0.</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
 
 &ini.descriptions.title;
 
 <para>
  <variablelist>
   <varlistentry xml:id="ini.phar.readonly">
    <term>
     <parameter>phar.readonly</parameter>
     <type>boolean</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>boolean</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>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.phar.extract-list">
    <term>
     <parameter>phar.extract_list</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Este ajuste INI ha sido eliminado desde phar 2.0.0
     </para>
     <para>
      Permite el mapeo desde una ruta completa a un archivo phar o su alias hacia
      la ubicación de sus ficheros extraídos.
      El formato del parámetro es <literal>nombre=archivo,nombre2=archivo2</literal>.
      Esto permite la extracción de ficheros phar al disco, y permite a phar acutar como una
      especie de mapeador para extraer ficheros de discos. A menudo, esto se reailza por motivos de
      rendimiento, o para ayudar a la depuración de un phar.
      <example>
       <title>phar.extract_list usage example</title>
       <programlisting role="php">
<![CDATA[
in php.ini:
phar.extract_list = archivo=/ruta/completa/al/archivo/,archivo2=/ruta/completa/al/archivo2
<?php
include "phar://archivo/contenido.php";
include "phar://archivo2/foo.php";
?>
]]>
       </programlisting>
      </example>
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.phar.cache-list">
    <term>
     <parameter>phar.cache_list</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Este ajuste INI fue añadido en 2.0.0
     </para>
     <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
-->