Sophie

Sophie

distrib > Mandriva > 9.1 > ppc > media > main > by-pkgid > 0afeee9cca140e167a996902b9a677c5 > files > 2415

php-manual-en-4.3.0-2mdk.noarch.rpm

<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 &#62;= 4.0.3)</P
>session_cache_limiter&nbsp;--&nbsp;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
>&#13;     <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
>&#13;     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
>&#13;     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
>&#13;     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"
>&#60;?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&#60;p&#62;";
?&#62;</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
><P
>&#13;     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
>