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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d22db7f5b0ed55d6f904549bd3116be900a0e8d3 Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<section xml:id="session.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Opciones de configuración de sesión</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.session.save-path">session.save_path</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.name">session.name</link></entry>
      <entry>"PHPSESSID"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.save-handler">session.save_handler</link></entry>
      <entry>"files"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.auto-start">session.auto_start</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_PERDIR</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.gc-probability">session.gc_probability</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.gc-divisor">session.gc_divisor</link></entry>
      <entry>"100"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 4.3.2.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.gc-maxlifetime">session.gc_maxlifetime</link></entry>
      <entry>"1440"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.serialize-handler">session.serialize_handler</link></entry>
      <entry>"php"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.cookie-path">session.cookie_path</link></entry>
      <entry>"/"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.cookie-domain">session.cookie_domain</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.cookie-secure">session.cookie_secure</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 4.0.4.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.cookie-httponly">session.cookie_httponly</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 5.2.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.use-strict-mode">session.use_strict_mode</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 5.5.2.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.use-cookies">session.use_cookies</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.use-only-cookies">session.use_only_cookies</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 4.3.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.referer-check">session.referer_check</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.entropy-file">session.entropy_file</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.entropy-length">session.entropy_length</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.cache-limiter">session.cache_limiter</link></entry>
      <entry>"nocache"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.cache-expire">session.cache_expire</link></entry>
      <entry>"180"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.session.use-trans-sid">session.use_trans_sid</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>PHP_INI_ALL en PHP &lt;= 4.2.3. PHP_INI_PERDIR en PHP &lt; 5. Disponible desde PHP 4.0.3.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.bug-compat-42">session.bug_compat_42</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 4.3.0. Eliminado en PHP 5.4.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 4.3.0. Eliminado en PHP 5.4.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.hash-function">session.hash_function</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 5.0.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.hash-bits-per-character">session.hash_bits_per_character</link></entry>
      <entry>"4"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 5.0.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.url-rewriter.tags">url_rewriter.tags</link></entry>
      <entry>"a=href,area=href,frame=src,form=,fieldset="</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 4.0.4.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.upload-progress.enabled">session.upload_progress.enabled</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_PERDIR</entry>
      <entry>Disponible desde PHP 5.4.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.upload-progress.cleanup">session.upload_progress.cleanup</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_PERDIR</entry>
      <entry>Disponible desde PHP 5.4.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.upload-progress.prefix">session.upload_progress.prefix</link></entry>
      <entry>"upload_progress_"</entry>
      <entry>PHP_INI_PERDIR</entry>
      <entry>Disponible desde PHP 5.4.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.upload-progress.name">session.upload_progress.name</link></entry>
      <entry>"PHP_SESSION_UPLOAD_PROGRESS"</entry>
      <entry>PHP_INI_PERDIR</entry>
      <entry>Disponible desde PHP 5.4.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.upload-progress.freq">session.upload_progress.freq</link></entry>
      <entry>"1%"</entry>
      <entry>PHP_INI_PERDIR</entry>
      <entry>Disponible desde PHP 5.4.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.upload-progress.min-freq">session.upload_progress.min_freq</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_PERDIR</entry>
      <entry>Disponible desde PHP 5.4.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.session.lazy-write">session.lazy_write</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible desde PHP 7.0.0.</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>
 <para>
  El sistema de administración de sesiones admite varias opciones de configuración
  que se pueden colocar en el fichero &php.ini;. Se dará una visión general
  breve.
  <variablelist>
   
   <varlistentry xml:id="ini.session.save-handler">
    <term>
     <parameter>session.save_handler</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.save_handler</literal> define el nombre del
      gestor que se usa para almacenar y recuperar información
      asociada con una sesión. Por defecto es
      <literal>files</literal>. Observe que las extensiones individuales pueden registrar
      sus propios gestores <literal>save_handler</literal>; los gestores registrados se pueden
      obtener a nivel de instalación consultando
      <function>phpinfo</function>. Véase también
      <function>session_set_save_handler</function>.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.save-path">
    <term>
     <parameter>session.save_path</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.save_path</literal> define el argumento que
      es pasado al gestor de almacenamiento. Si se elige el gestor de archivos
      por defecto, éste es la ruta donde los archivos son creados. Véase también
      <function>session_save_path</function>. 
     </simpara>
     <para>
      Hay un argumento opcional <literal>N</literal> para esta directiva que determina
      el número de niveles de directorios por donde los archivos de sesión se
      desplegarán. Por ejemplo, establecerlo a <literal>'5;/tmp'</literal>
      puede terminar en crear un archivo de sesión y ubicación como
      <literal>/tmp/4/b/1/e/3/sess_4b1e384ad74619bd212e236e52a5a174If
      </literal>. Para usar <literal>N</literal> se deben crear todos estos
      directorios antes de utilizarlo. Para realizar esto, existe un pequeño script
      tipo shell en <filename>ext/session</filename> que se llama
      <filename>mod_files.sh</filename>, con una versión de Windows llamada
      <filename>mod_files.bat</filename>. Observe también que si <literal>N</literal> se
      usa y es más grande que 0 no se llevará a cabo la recolección de basura
      automática, vea una copia de &php.ini; para más
      información. También, si usa <literal>N</literal>, asegúrese de encerrar
      <literal>session.save_path</literal> entre
      "comillas" ya que el separador (<literal>;</literal>) también
      se usa para comentarios en &php.ini;.
     </para>
     <para>
      El módulo de almacenamiento de ficheros crea ficheros usando el modo 600 de forma predeterminada.
      Este valor se puede cambiar con el argumento opcional <literal>MODE</literal>:
      <literal>N;MODE;/path</literal>, donde <literal>MODE</literal> es la representación
      octal del modo.
      Establecer <literal>MODE</literal> no afecta al proceso umask.
     </para>
     <warning>
      <para>
       Si se deja esta configuración para un directorio legilble por todo el mundo, tal como
       <filename>/tmp</filename> (por defecto), otros usuarios en el servidor
       pueden ser capaces de secuestrar sesiones obteniendo la lista de
       archivos de ese directorio.
      </para>
     </warning>
     <caution>
      <para>
       Al emplear el argumento opcional de nivel de directorio <literal>N</literal>,
       como está descrito arriba, observe que al utilizar un valor mayor que 1 o 2 no
       es apropiado para la mayoría de los sitios debido al gran número de directorios
       requeridos: por ejemplo, un valor de 3 implica que existen <literal>64^3</literal>
       directorios en el sistema de ficheros, lo que puede resultar en un gran despredicio
       de escpacio e inodos.
      </para>
      <para>
       Utilice solamente <literal>N</literal> con un valor mayor que 2 si está absolutamente
       seguro de que el sitio es lo suficientemente grande para requerirlo.
      </para>
     </caution>
     <note>
      <simpara>
       Antes de PHP 4.3.6, los usuarios de Windows tenían que cambiar esta variable para
       usar las funciones de sesiones de PHP. Se debe especificar una ruta válida, p.ej.:
       <filename>c:/temp</filename>.
      </simpara>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.name">
    <term>
     <parameter>session.name</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.name</literal> specifica el nombre de la
      sesión que se usa como nombre de cookie. Sólo debería contener
      caracteres alfanuméricos. Por defecto es <literal>PHPSESSID</literal>.
      Véase también <function>session_name</function>.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.auto-start">
    <term>
     <parameter>session.auto_start</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.auto_start</literal> especifica si el
      módulo de sesión inicia una sesión automáticamente cuando arranque una
      petición. Por defecto es <literal>0</literal> (deshabilitado).
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.serialize-handler">
    <term>
     <parameter>session.serialize_handler</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.serialize_handler</literal> define el nombre
      del manejador que se usa para serializar/deserializar datos. El formato
      de serialización de PHP (nombre <literal>php_serialize</literal>), formatos
      de internos de PHP (nombre <literal>php</literal> y
      <literal>php_binary</literal>) y WDDX son admitidos (nombre
      <literal>wddx</literal>). WDDX solamente está disponible si PHP está
      compilado con <link linkend="ref.wddx">soporte para
      WDDX</link>. <literal>php_serialize</literal> está disponible
      desde PHP 5.5.4. <literal>php_serialize</literal> usa internamente una
      función pura de serialización/deserialización y no tiene
      las limitaciones que tienen <literal>php</literal>
      y <literal>php_binary</literal>. Los gestores de serialización más antiguos
      no pueden almacenar índices numéricos ni de string que contengan caracters
      especiales (<literal>|</literal> y <literal>!</literal>) en
      $_SESSION. Use <literal>php_serialize</literal> para evitar errores con
      índices numéricos o caracteres especiales al cierre del script. Lo predeterminado
      es <literal>php</literal>.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.gc-probability">
    <term>
     <parameter>session.gc_probability</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.gc_probability</literal> se usa junto con
      <literal>session.gc_divisor</literal> para manejar la probabilidad de
      que la rutina de gc (garbage collection, recolección de basura) está iniciada.
      Por defecto es <literal>1</literal>. Véase <link
      linkend="ini.session.gc-divisor">session.gc_divisor</link> para más detalles.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.gc-divisor">
    <term>
     <parameter>session.gc_divisor</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.gc_divisor</literal> junto con
      <literal>session.gc_probability</literal> define la probabilidad de
      que el proceso de gc (garbage collection, recolección de basura) esté iniciado en
      cada inicialización de sesión.
      La probabilidad se calcula usando gc_probability/gc_divisor,
      p.ej. 1/100 significa que hay un 1% de probabilidad de que el proceso de GC se inicie
      en cada petición.
      <literal>session.gc_divisor</literal> por defecto es <literal>100</literal>.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.gc-maxlifetime">
    <term>
     <parameter>session.gc_maxlifetime</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.gc_maxlifetime</literal> especifica el número
      de segudos transcurridos después de que la información sea vista como 'basura' y
      potencialmente limpiada. La recolección de basura puede suceder durante el inicio de sesiones
      (dependiendo de <link
      linkend="ini.session.gc-probability">session.gc_probability</link> y
      <link linkend="ini.session.gc-divisor">session.gc_divisor</link>).
     </simpara>
     <note>
      <para>
       Si diferentes scripts tienen diferentes valores de
       <literal>session.gc_maxlifetime</literal> pero comparten la misma ubicación para
       almacenar la información de sesión, la información del script con el mínimo valor
       será limpiada. En este caso use esta directiva junto con <link
       linkend="ini.session.save-path">session.save_path</link>.
      </para>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.referer-check">
    <term>
     <parameter>session.referer_check</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.referer_check</literal> contiene la
      subcadena para comprobar cada HTTP Referer. Si la
      Referencia fue enviada por el cliente y la subcadena no se
      encontró, el id de sesión embebido será marcado como no válido.
      Por defecto es una cadena vacía.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.entropy-file">
    <term>
     <parameter>session.entropy_file</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.entropy_file</literal> da una ruta a un
      recurso externo (archivo) que será usado como una fuente de entropía
      adicional en el proceso de creación del id de sesión. Ejemplos:
      <literal>/dev/random</literal> o <literal>/dev/urandom</literal>
      que están disponibles en la mayoría de sistemas Unix.
     </simpara>
     <simpara>
      Esta función está disponible en Windows desde PHP 5.3.3. Si se establece
      <literal>session.entropy_length</literal> a un valor que no sea cero
      hará que PHP use la Windows Random API como fuente entrópica.
     </simpara>
     <note>
      <simpara>
       A partir de PHP 5.4.0 <literal>session.entropy_file</literal> usa de forma predeterminada
       <literal>/dev/urandom</literal> o <literal>/dev/arandom</literal>
       si están disponibles. En PHP 5.3.0, esta directiva se deja vacía por omisión.
      </simpara>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.entropy-length">
    <term>
     <parameter>session.entropy_length</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.entropy_length</literal> especifica el número
      de bytes que serán leídos desde el archivo especificado arriba.
      Por defecto es <literal>0</literal> (deshabilitado).
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.use-strict-mode">
    <term>
     <parameter>session.use_strict_mode</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.use_strict_mode</literal> especifica si el
      módulo usará el modo de id de sesión estricto. Si este modo está habilitado,
      el módulo no aceptará IDs de sesioines no inicializados. Si se envia desde el
      navegador un ID de sesión no inicializado, se envía un nuevo ID de sesión al navegador.
      Las aplicaciones están protegidas de la fijación de sesiones mediante la adopción de sesión
      con modo estricto.
      El valor predeterminado es <literal>0</literal> (deshabilitado).
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.use-cookies">
    <term>
     <parameter>session.use_cookies</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.use_cookies</literal> especifica si el
      módulo usará cookies para almacenar el id de sesión en la parte
      del cliente. Por defecto es <literal>1</literal> (habilitado).
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.use-only-cookies">
    <term>
     <parameter>session.use_only_cookies</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.use_only_cookies</literal> especifica si
      el módulo <emphasis role="strong">sólo</emphasis> usará
      cookies para almacenar el id de sesión en la parte del cliente.
      Habilitar este ajuste previene ataques que impican pasar el id
      de sesión en la URL. Este ajuste fue añadido en PHP 4.3.0.
      Por defecto es <literal>1</literal> (habilitado) desde PHP 5.3.0.
     </simpara>
    </listitem>
   </varlistentry>
   
   
   <varlistentry xml:id="ini.session.cookie-lifetime">
    <term>
     <parameter>session.cookie_lifetime</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.cookie_lifetime</literal> especifica el tiempo de vida en
      segundos de la cookie que es enviada al navegador. El valor 0
      significa "hasta que el navegador se cierre". Por defecto es
      <literal>0</literal>. Véase también
      <function>session_get_cookie_params</function> y
      <function>session_set_cookie_params</function>.
     </simpara>
     <note>
      <para>
       La marca de tiempo de caducidad se establece relativa a la hora del servidor, la cúal no es
       necesariamente la misma que la hora del navegador del cliente.
      </para>
     </note> 
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.cookie-path">
    <term>
     <parameter>session.cookie_path</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.cookie_path</literal> especifica la ruta a establecer
      en la cookie de sesión. Por defecto es <literal>/</literal>. Véase también
      <function>session_get_cookie_params</function> y
      <function>session_set_cookie_params</function>.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.cookie-domain">
    <term>
     <parameter>session.cookie_domain</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.cookie_domain</literal> especifica el dominio a
      establecer en la cookie de sesión. Por defecto es ninguno, significando el nombre de host del
      servidor que generó la cookie según la especificación de cookies.
      Véase también <function>session_get_cookie_params</function> y
      <function>session_set_cookie_params</function>.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.cookie-secure">
    <term>
     <parameter>session.cookie_secure</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.cookie_secure</literal> especifica si las
      cookies deberían enviarse sólo sobre conexiones seguras. Por defecto es
      <literal>off</literal>.
      Este ajuste fue añadido en PHP 4.0.4. Véase también
      <function>session_get_cookie_params</function> y
      <function>session_set_cookie_params</function>.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.cookie-httponly">
    <term>
     <parameter>session.cookie_httponly</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      Marca la cookie como accesible sólo a través del protocolo HTTP. Esto siginifica
      que la cookie no será accesible por lenguajes de script, tales como
      JavaScript. Este ajuste puede ayudar de manera efectiva a reducir robos de indentidad
      a través de ataques (aunque no está soportado por todos los navegadores).
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.cache-limiter">
    <term>
     <parameter>session.cache_limiter</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.cache_limiter</literal> especifica el método
      de control de caché usado por páginas de sesión.
      Puede ser uno de los siguientes valores:
      <literal>nocache</literal>, <literal>private</literal>, 
      <literal>private_no_expire</literal>, o <literal>public</literal>.
      Por defecto es <literal>nocache</literal>. Vea también la
      documentación de <function>session_cache_limiter</function> para
      informarse sobre lo que significan estos valores.
     </simpara>
    </listitem>
   </varlistentry>
   
   
   <varlistentry xml:id="ini.session.cache-expire">
    <term>
     <parameter>session.cache_expire</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.cache_expire</literal> especifica el tiempo de vida
      en minutos para las páginas de sesión examinadas, esto no tiene efecto para
      el limitador nocache. Por defecto es <literal>180</literal>. Véase también
      <function>session_cache_expire</function>.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.use-trans-sid">
    <term>
     <parameter>session.use_trans_sid</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.use_trans_sid</literal> si está habilitado sid
      transparente o no. Por defecto es
      <literal>0</literal> (deshabilitado).
     </simpara>
     <note>
      <simpara>
       La administración de sesiones basadas en URL tiene riesgos de seguridad adicionales
       comparada con la administración de sesiones basdas en cookies. Los usuarios pueden enviar
       una URL que contenga un ID de sesión activo a sus amigos mediante
       email o los usuarios pueden guardar una URL que contenga una ID de sesión en
       sus marcadores y acceder a su sitio siempre con el mismo ID de sesión, por ejemplo.
      </simpara>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.bug-compat-42">
    <term>
     <parameter>session.bug_compat_42</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      Las versiones de PHP 4.2.3 y anteriores tienen una característica/error no documentada que
      permite inicializar una variable de sesión en el ámbito global,
      aunque <link linkend="ini.register-globals">register_globals</link>
      esté deshabilitado. PHP 4.3.0 y posteriores le avisarán, si se usa esta característica,
      y si <link linkend="ini.session.bug-compat-warn">
      session.bug_compat_warn</link> también está habilitado. Esta característica/error puede ser
      desactivada deshabilitando esta directiva.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.bug-compat-warn">
    <term>
     <parameter>session.bug_compat_warn</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      Las versiones de PHP 4.2.3 y anteriores tienen una característica/error no documentada que
      permite inicializar una variable de sesión en el ámbito global,
      aunque <link linkend="ini.register-globals">register_globals</link>
      esté deshabilitado. PHP 4.3.0 y posteriores le avisarán, si se usa esta característica
      habilitando
      <link linkend="ini.session.bug-compat-42">session.bug_compat_42</link>
      y <link linkend="ini.session.bug-compat-warn">
      session.bug_compat_warn</link>.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.hash-function">
    <term>
     <parameter>session.hash_function</parameter>
     <type>mixed</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.hash_function</literal> permite especificar el algoritmo
      hash utilizado para generar los ID de sesión. '0' significa MD5 (128 bits) y
      '1' significa SHA-1 (160 bits).
     </simpara>
     <para>
      Desde PHP 5.3.0 también es posible especificar cualquier algoritmo
      porporcionado por la <link linkend="ref.hash">extensión hash</link> (si está
      disponible), como <literal>sha512</literal> o
      <literal>whirlpool</literal>. Una lista completa de los algoritmos soportados se puede
      obtener con la función <function>hash_algos</function>.
     </para>
     <note>
      <para>
       Este ajuste fue introducido en PHP 5.
      </para>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.hash-bits-per-character">
    <term>
     <parameter>session.hash_bits_per_character</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.hash_bits_per_character</literal> permite definir
      cuántos bits son almacenados en cada carácter cuando se convierte la información
      hash binaria a algo legible. Los valores posibles son '4' (0-9, a-f),
      '5' (0-9, a-v), y '6' (0-9, a-z, A-Z, "-", ",").
     </simpara>
     <note>
      <para>
       Esto fue introducido en PHP 5.
      </para>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.url-rewriter.tags">
    <term>
     <parameter>url_rewriter.tags</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      <literal>url_rewriter.tags</literal> especifica qué etiquetas HTML
      son reescritas para incluir el id de sesión si el soporte para sid transparente
      está habilitado. Por defecto es
      <literal>a=href,area=href,frame=src,input=src,form=fakeentry,fieldset=</literal>
     </simpara>
     <note>
      <simpara>
       Si quiere compatibilidad para HTML/XHTML estricto, elimine la entrada <literal>form</literal> y
       use las etiquetas &lt;fieldset&gt; alrededor de sus campos de formulario.
      </simpara>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.upload-progress.enabled">
    <term>
     <parameter>session.upload_progress.enabled</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      Habilita el seguimiento del progreso de subida de ficheros, rellenado la variable <varname>$_SESSION</varname>.
      Por omisión su valor es 1, habilitado.
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.upload-progress.cleanup">
    <term>
     <parameter>session.upload_progress.cleanup</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      Limpieza de la información del progreso al finalizar la lectura de los datos del POST     
      (p.ej. al finalizar la subida). Por omisión su valor es 1, habilitado.
     </simpara>
     <note>
      <simpara>
       Es muy recomendado mantener esta opción habilitada.      
      </simpara>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.upload-progress.prefix">
    <term>
     <parameter>session.upload_progress.prefix</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      Prefijo usado para la clave del progreso de subida en <varname>$_SESSION</varname>.
      Esta clave será concatenada con el valor de     
      <literal>$_POST[ini_get("session.upload_progress.name")]</literal> para
      proporcionar un índice único.
     </simpara>
     <simpara>
      Por omisión su valor es "upload_progress_".
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.upload-progress.name">
    <term>
     <parameter>session.upload_progress.name</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      El nombre de la clave a usar en <varname>$_SESSION</varname> para guardar
      la información del progreso de subida. Ver también
      <link linkend="ini.session.upload-progress.prefix">session.upload_progress.prefix</link>.
     </simpara>
     <simpara>
      Si no se pasa <literal>$_POST[ini_get("session.upload_progress.name")]</literal>
      o no está disponible, el progreso de subida no será grabado.
     </simpara>
     <simpara>
      Por omisión su valor es"PHP_SESSION_UPLOAD_PROGRESS".
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.upload-progress.freq">
    <term>
     <parameter>session.upload_progress.freq</parameter>
     <type>mixed</type>
    </term>
    <listitem>
     <simpara>
      Determina cada cuanto debería actualizarse la información del proceso de subida.
      Este valor puede ser definido en bytes (p.ej. "actualiza la información del progreso de subida después de cada 100 bytes"), o en porcentajes (p.ej. "actualiza la información del proceso de subida después de recibir el 1% del total del tamaño del fichero").
     </simpara>
     <simpara>
      Por omisión "1%".
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.upload-progress.min-freq">
    <term>
     <parameter>session.upload_progress.min-freq</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <simpara>
      El retraso mínimo entre actualizaciones, en segundos.     
      Por omisión su valor es "1" (un segundo).
     </simpara>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.session.lazy-write">
    <term>
     <parameter>session.lazy_write</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <simpara>
      <literal>session.lazy_write</literal>, cuando está establecida a 1, significa que los datos
      de sesión solamente son rescritos si cambian. El valor predeterminado es 1, habilitado.
     </simpara>
    </listitem>
   </varlistentry>
   
  </variablelist>
 </para>
 
 <para>
  El ajuste de configuración 
  <link
  linkend="ini.register-globals"><literal>register_globals</literal></link>
  influye en cómo las variables de sesión se
  almacenan y se restablecen.
 </para>
 
 <para>
  El progreso de subida no será registrado a no ser que
  session.upload_progress.enabled esté habilitado, y la variable
  $_POST[ini_get("session.upload_progress.name")] esté definida.
  Ver <link linkend="session.upload-progress">Session Upload Progress</link> para más información de como funciona.
 </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
     -->