php-doc-en/reference/session/functions/session-cache-limiter.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- splitted from ./en/functions/session.xml, last change in rev 1.62 -->
<refentry id="function.session-cache-limiter">
 <refnamediv>
  <refname>session_cache_limiter</refname>
  <refpurpose>Get and/or set the current cache limiter</refpurpose>
 </refnamediv>
 <refsect1>
  <title>Description</title>
  <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> returns the name of the
   current cache limiter. If <parameter>cache_limiter</parameter>
   is specified, the name of the current cache limiter is changed to the
   new value.
  </para>
  <para>
   The cache limiter defines which cache control HTTP headers are sent to
   the client.  These headers determine the rules by which the page content
   may be cached by the client and intermediate proxies.  Setting the cache
   limiter to <literal>nocache</literal> disallows any client/proxy caching.
   A value of <literal>public</literal> permits caching by proxies and the
   client, whereas <literal>private</literal> disallows caching by proxies
   and permits the client to cache the contents.
  </para>
  <para>
   In <literal>private</literal> mode, the Expire header sent to the
   client may cause confusion for some browsers, including Mozilla.
   You can avoid this problem by using
   <literal>private_no_expire</literal> mode. The expire header is never
   sent to the client in this mode.
  </para>
  <note>
   <para>
    <literal>private_no_expire</literal> was added in PHP 4.2.0.
   </para>
  </note>
  <para>
   The cache limiter is reset to the default value stored in
   <link linkend="ini.session.cache-limiter">session.cache_limiter</link>
   at request startup time. Thus, you need to call
   <function>session_cache_limiter</function> for every
   request (and before <function>session_start</function> is called).
  </para>
  <example>
   <title><function>session_cache_limiter</function> example</title>
   <programlisting role="php">
<![CDATA[
<?php

/* set the cache limiter to 'private' */

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

echo "The cache limiter is now set to $cache_limiter<br />";
?>
]]>
   </programlisting>
  </example>
  <para>
   Also see the <link linkend="ini.session.cache-limiter">session.cache_limiter</link>
   configuration directive.
  </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:"../../../../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
-->