session-cache-limiter.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8b5940cadeb4f1c8492f4a7f70743a2be807cf39 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-cache-limiter">
 <refnamediv>
  <refname>session_cache_limiter</refname>
  <refpurpose>Obtener y/o establecer el limitador de caché actual</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>session_cache_limiter</methodname>
   <methodparam choice="opt"><type>string</type><parameter>cache_limiter</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>session_cache_limiter</function> devuelve el nombre del
   limitador de caché actual.
  </para>
  <para>
   El limitador de caché define cuáles cabeceras HTTP de control de caché son enviadas
   al cliente. Estas cabeceras determinan las normas por las cuáles el contenido de la página
   puede ser examinada por el cliente y por los proxies intermediarios. Establecer el limitador
   de caché a <literal>nocache</literal> rechaza cualquier examen por parte del cliente/proxy.
   Un valor de <literal>public</literal> permite la examen por proxies y el
   client, mientras que <literal>private</literal> rechaza la examen por proxies
   y permite al cliente examinar el contenido.
  </para>
  <para>
   En modo <literal>private</literal>, la cabecera Expire enviada al cliente
   puede causar confusión a algunos navegadores, incluido <productname>Mozilla</productname>.
   Se puede evitar este problema usando el modo <literal>private_no_expire</literal>. La
   cabecera <literal>Expire</literal> nunca se envía al cliente en este modo.
  </para>
  <para>
   Establecer el limitador de caché a <literal>''</literal> desactivará el envío automático
   de las cabeceras de caché completamente.
  </para>
  <para>
   El limitador de caché se reinicia a su valor predeterminado almacenado en
   <link linkend="ini.session.cache-limiter">session.cache_limiter</link>
   en el momento de iniciar una petición. Por lo tanto, se necesita llamar a
   <function>session_cache_limiter</function> para cada
   petición (y antes de llamar a <function>session_start</function>).
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>cache_limiter</parameter></term>
     <listitem>
      <para>
       Si se especifica <parameter>cache_limiter</parameter>, el nombre del
       limitador de caché actual se cambia por el nuevo valor.
      </para>
      <table>
       <title>Valores posibles</title>
       <tgroup cols="2">
        <thead>
         <row>
          <entry>Valor</entry>
          <entry>Cabeceras enviadas</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry><literal>public</literal></entry>
          <entry>
           <programlisting role="header">
<![CDATA[
Expires: (algún momento en el futuro, según session.cache_expire)
Cache-Control: public, max-age=(algún momento en el futuro, según session.cache_expire)
Last-Modified: (la marca de tiempo de cuando la sesión fue guardada por última vez)
]]>
           </programlisting>
          </entry>
         </row>
         <row>
          <entry><literal>private_no_expire</literal></entry>
          <entry>
           <programlisting role="header">
<![CDATA[
Cache-Control: private, max-age=(session.cache_expire en el futuro), pre-check=(session.cache_expire en el futuro)
Last-Modified: (la marca de tiempo de cuando la sesión fue guardada por última vez)
]]>
           </programlisting>
          </entry>
         </row>
         <row>
          <entry><literal>private</literal></entry>
          <entry>
           <programlisting role="header">
<![CDATA[
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: private, max-age=(session.cache_expire en el futuro), pre-check=(session.cache_expire en el futuro)
Last-Modified: (la marca de tiempo de cuando la sesión fue guardada por última vez)
]]>
           </programlisting>
          </entry>
         </row>
         <row>
          <entry><literal>nocache</literal></entry>
          <entry>
           <programlisting role="header">
<![CDATA[
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Pragma: no-cache
]]>
           </programlisting>
          </entry>
         </row>
        </tbody>
       </tgroup>
      </table>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve el nombre del limitador de caché actual.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>session_cache_limiter</function></title>
    <programlisting role="php">
<![CDATA[
<?php

/* establecer el limitador de caché a 'private' */

session_cache_limiter('private');
$cache_limiter = session_cache_limiter();

echo "El limitador de caché ahora está establecido a $cache_limiter<br />";
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><link linkend="ini.session.cache-limiter">session.cache_limiter</link></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>

<!-- 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
-->