<HTML ><HEAD ><TITLE >session_cache_limiter</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="Session handling functions" HREF="ref.session.html"><LINK REL="PREVIOUS" TITLE="session_cache_expire" HREF="function.session-cache-expire.html"><LINK REL="NEXT" TITLE="session_decode" HREF="function.session-decode.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="refentry" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.session-cache-expire.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.session-decode.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.session-cache-limiter" ></A >session_cache_limiter</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN84350" ></A ><P > (PHP 4 >= 4.0.3)</P >session_cache_limiter -- Get and/or set the current cache limiter</DIV ><DIV CLASS="refsect1" ><A NAME="AEN84353" ></A ><H2 >Description</H2 >string <B CLASS="methodname" >session_cache_limiter</B > ( [string cache_limiter])<BR ></BR ><P > <B CLASS="function" >session_cache_limiter()</B > returns the name of the current cache limiter. If <TT CLASS="parameter" ><I >cache_limiter</I ></TT > is specified, the name of the current cache limiter is changed to the new value. </P ><P > 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 <TT CLASS="literal" >nocache</TT > disallows any client/proxy caching. A value of <TT CLASS="literal" >public</TT > permits caching by proxies and the client, whereas <TT CLASS="literal" >private</TT > disallows caching by proxies and permits the client to cache the contents. </P ><P > In <TT CLASS="literal" >private</TT > mode, the Expire header sent to the client may cause confusion for some browsers, including Mozilla. You can avoid this problem by using <TT CLASS="literal" >private_no_expire</TT > mode. The expire header is never sent to the client in this mode. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Note: </B > <TT CLASS="literal" >private_no_expire</TT > was added in PHP 4.2.0. </P ></BLOCKQUOTE ></DIV ><P > The cache limiter is reset to the default value stored in <A HREF="ref.session.html#ini.session.cache-limiter" >session.cache_limiter</A > at request startup time. Thus, you need to call <B CLASS="function" >session_cache_limiter()</B > for every request (and before <A HREF="function.session-start.html" ><B CLASS="function" >session_start()</B ></A > is called). </P ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN84378" ></A ><P ><B >Example 1. <B CLASS="function" >session_cache_limiter()</B > example</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="php" ><?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<p>"; ?></PRE ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ><P > Also see the <A HREF="ref.session.html#ini.session.cache-limiter" >session.cache_limiter</A > configuration directive. </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.session-cache-expire.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.session-decode.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >session_cache_expire</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ref.session.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >session_decode</TD ></TR ></TABLE ></DIV ></BODY ></HTML >