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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b1116af46680f7baf89c46610430a3b63ce9a1f0 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<section xml:id="info.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
 <table>
   <title>&ConfigureOptions;</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.assert.active">assert.active</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>
      Obsoleto a partir de PHP 8.3.0
     </entry>
    </row>
    <row>
     <entry><link linkend="ini.assert.bail">assert.bail</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>
      Obsoleto a partir de PHP 8.3.0
     </entry>
    </row>
    <row>
     <entry><link linkend="ini.assert.warning">assert.warning</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>
      Obsoleto a partir de PHP 8.3.0
     </entry>
    </row>
    <row>
     <entry><link linkend="ini.assert.callback">assert.callback</link></entry>
     <entry>NULL</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>
      Obsoleto a partir de PHP 8.3.0
     </entry>
    </row>
    <row>
     <entry><link linkend="ini.assert.quiet-eval">assert.quiet_eval</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>Eliminado a partir de PHP 8.0.0</entry>
    </row>
    <row>
     <entry><link linkend="ini.assert.exception">assert.exception</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>
      Anterior a PHP 8.0.0, el valor por defecto es <literal>"0"</literal>
      Obsoleto a partir de PHP 8.3.0
     </entry>
    </row>
    <row>
     <entry><link linkend="ini.enable-dl">enable_dl</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry>&removed.php.future;</entry>
    </row>
    <row>
     <entry><link linkend="ini.max-execution-time">max_execution_time</link></entry>
     <entry>"30"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.max-input-time">max_input_time</link></entry>
     <entry>"-1"</entry>
     <entry><constant>INI_PERDIR</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.max-input-nesting-level">max_input_nesting_level</link></entry>
     <entry>"64"</entry>
     <entry><constant>INI_PERDIR</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.max-input-vars">max_input_vars</link></entry>
     <entry>1000</entry>
     <entry><constant>INI_PERDIR</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.zend.enable-gc">zend.enable_gc</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.zend.max-allowed-stack-size">zend.max_allowed_stack_size</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry>Disponible a partir de PHP 8.3.0.</entry>
    </row>
    <row>
     <entry><link linkend="ini.zend.reserved-stack-size">zend.reserved_stack_size</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry>Disponible a partir de PHP 8.3.0.</entry>
    </row>
    <row>
     <entry><link linkend="ini.fiber.stack-size">fiber.stack_size</link></entry>
     <entry></entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>Disponible a partir de PHP 8.1.0.</entry>
    </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>
 &ini.descriptions.title;
 <para>
  <variablelist>
   <varlistentry xml:id="ini.assert.active">
    <term>
     <parameter>assert.active</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Activa las evaluaciones de tipo <function>assert</function>.
      <link linkend="ini.zend.assertions">zend.assertions</link> debería ser
      utilizado en su lugar para controlar el comportamiento de <function>assert</function>.
     </para>
      &warn.deprecated.feature-8-3-0;
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.assert.bail">
    <term>
     <parameter>assert.bail</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Termina el script si una aserción falla.
     </para>
      &warn.deprecated.feature-8-3-0;
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.assert.warning">
    <term>
     <parameter>assert.warning</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Emite una alerta PHP para cada aserción que falle.
     </para>
      &warn.deprecated.feature-8-3-0;
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.assert.callback">
    <term>
     <parameter>assert.callback</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Función definida por el programador, a llamar para cada
      aserción fallida.
     </para>
      &warn.deprecated.feature-8-3-0;
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.assert.quiet-eval">
    <term>
     <parameter>assert.quiet_eval</parameter>
     <type>bool</type>
    </term>
    <listitem>
     &warn.feature.removed-8-0-0;
     <para>
      Utiliza la configuración actual de <function>error_reporting</function>
      durante las evaluaciones de aserciones. Si está activada, ningún error es
      mostrado (error_reporting(0) implícito) durante la evaluación. Si está desactivada,
      los errores son mostrados según la configuración de
      <function>error_reporting</function>
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.assert.exception">
    <term>
     <parameter>assert.exception</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Lanza una excepción <classname>AssertionError</classname> cuando una
      aserción falla.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.enable-dl">
    <term>
      <parameter>enable_dl</parameter>
      <type>bool</type>
    </term>
    <listitem>
     <para>
      Esta directiva permite activar o desactivar
      la carga dinámica de extensiones PHP con la función PHP <function>dl</function>.
     </para>
     <para>
      La razón principal para desactivar este sistema es la seguridad.
      Con la carga dinámica, es posible eludir
      las restricciones impuestas por
      <link linkend="ini.open-basedir">open_basedir</link>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.max-execution-time">
    <term>
     <parameter>max_execution_time</parameter>
      <type>int</type>
    </term>
    <listitem>
     <para>
      Establece el tiempo máximo de ejecución de un script,
      en segundos. Esto evita que los scripts en
      bucles infinitos saturen el servidor. La configuración por
      defecto es de <literal>30</literal> segundos. Cuando PHP
      funciona desde la <link linkend="features.commandline">línea
      de comando</link>, el valor por defecto es <literal>0</literal>.
     </para>
     <para>
      En sistemas no-Windows, el tiempo máximo de ejecución no se ve afectado por
      llamadas al sistema como <function>sleep</function>.
      Consulte la función <function>set_time_limit</function>
      para más detalles.
     </para>
     <para>
      El servidor web puede tener otras configuraciones de tiempo límite
      de ejecución que también pueden interrumpir PHP. Apache tiene una directiva
      <literal>Timeout</literal> e IIS tiene una función CGI para ello.
      Por defecto, ambas valen 300 segundos. Consulte
      la documentación del servidor web para más detalles.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.max-input-time">
    <term>
     <parameter>max_input_time</parameter>
      <type>int</type>
    </term>
    <listitem>
     <para>
      Esta opción especifica la duración máxima para analizar
      los datos de entrada, como POST y GET.
      Esta duración se mide desde el momento en que PHP es invocado en el
      servidor hasta el inicio de la ejecución del script.
      El valor por defecto es <literal>-1</literal>, lo que significa que
      <link linkend="ini.max-execution-time">max_execution_time</link>
      es utilizado en su lugar. Establecer el valor a <literal>0</literal> para permitir una ejecución ilimitada.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.max-input-nesting-level">
    <term>
     <parameter>max_input_nesting_level</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Define la profundidad máxima de las
      <link linkend="language.variables.external">variables de entrada</link> (es decir,
      <varname>$_GET</varname>, <varname>$_POST</varname>..)
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.max-input-vars">
    <term>
     <parameter>max_input_vars</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      El número de <link linkend="language.variables.external">variables de entrada</link>
      que pueden ser aceptadas (este límite se aplica a las variables
      superglobales $_GET, $_POST y $_COOKIE, por separado). El uso de esta directiva
      permite limitar las posibilidades de ataque por denegación de servicio
      utilizando colisiones de hash. Si hay más variables de entrada que el número especificado por esta directiva, una
      alerta de tipo <constant>E_WARNING</constant> será emitida, y las
      variables adicionales serán eliminadas de la solicitud.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.zend.enable-gc">
    <term>
     <parameter>zend.enable_gc</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Activa o desactiva la recolección de referencias circulares.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.zend.max-allowed-stack-size">
    <term>
     <parameter>zend.max_allowed_stack_size</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      La cantidad máxima de memoria de pila nativa (stack) permitida por el
      sistema operativo para el programa.
      Intentar consumir más de lo que el sistema permite generalmente resulta
      en un fallo brusco, sin información de depuración
      fácilmente disponible.
      Para facilitar la depuración, el motor lanza una
      <classname>Error</classname>
      antes de que esto ocurra (cuando el programa utiliza más de
      <link linkend="ini.zend.max-allowed-stack-size">zend.max_allowed_stack_size</link>-<link linkend="ini.zend.reserved-stack-size">zend.reserved_stack_size</link>
      bytes de pila).
     </para>
     <para>
      La recursión en el código definido por el usuario no consume
      pila nativa. Sin embargo, las funciones internas y los métodos mágicos, sí
      consumen pila nativa.
      Una recursión muy profunda que involucre estas funciones puede hacer que el programa
      agote toda la memoria de pila disponible.
     </para>
     <para>
      Los valores posibles para este parámetro son:
      <simplelist>
       <member>
        <literal>0</literal> :
        Detectar automáticamente la memoria de pila nativa máxima que el sistema
        operativo permite para el programa.
        Este es el valor por defecto.
        Cuando la detección es imposible, se utiliza un valor por defecto del sistema.
       </member>
       <member>
        <literal>-1</literal> : Desactiva la verificación del tamaño de la pila en el motor.
       </member>
       <member>
        Entero positivo : Un tamaño fijo, en bytes.
        Establecer este valor demasiado alto equivale a desactivar la verificación de la
        tamaño de la pila.
       </member>
      </simplelist>
     </para>
     <para>
      Como el tamaño de pila
      <link linkend="language.fibers">de las fibers</link>
      está determinado por
      <link linkend="ini.fiber.stack-size">fiber.stack_size</link>,
      el valor de este parámetro es utilizado en lugar de
      <link linkend="ini.zend.max-allowed-stack-size">zend.max_allowed_stack_size</link>
      durante la verificación del uso de la pila durante la ejecución de una Fiber.
     </para>
     <note>
      <para>
       Esto no tiene ninguna relación con los desbordamientos de búfer de pila
       <emphasis>(stack buffer overflows)</emphasis>, y no es una funcionalidad de seguridad.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.zend.reserved-stack-size">
    <term>
     <parameter>zend.reserved_stack_size</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      El tamaño reservado de la pila, en bytes.
      Este se resta de la
      <link linkend="ini.zend.max-allowed-stack-size">tamaño máximo de pila permitido</link>,
      como un margen de seguridad, durante la verificación del tamaño de la pila.
     </para>
     <para>
      Los valores posibles para este parámetro son:
      <simplelist>
       <member>
        <literal>0</literal> : Detectar automáticamente un tamaño razonable.
       </member>
       <member>
        Entero positivo : Un tamaño fijo, en bytes.
       </member>
      </simplelist>
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.fiber.stack-size">
    <term>
     <parameter>fiber.stack_size</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      El tamaño de la pila nativa, en bytes, asignada a cada
      <link linkend="language.fibers">Fiber</link>.
     </para>
     <para>
      El valor por defecto es de 1 Mio en sistemas donde el tamaño de los punteros
      es inferior a 8 bytes, o de 2 Mio en caso contrario.
     </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
-->