Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > by-pkgid > 05cd670d8a02b2b4a0ffb1756f2e8308 > files > 7845

php-manual-zh-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Memcache::set</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="Memcache Functions"
HREF="ref.memcache.html"><LINK
REL="PREVIOUS"
TITLE="Memcache::replace"
HREF="function.memcache-replace.html"><LINK
REL="NEXT"
TITLE="Memcache::setCompressThreshold"
HREF="function.memcache-setcompressthreshold.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></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 手册</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.memcache-replace.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.memcache-setcompressthreshold.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.Memcache-set"
></A
>Memcache::set</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN118722"
></A
><P
>    (no version information, might be only in CVS)</P
>Memcache::set&nbsp;--&nbsp;Store data at the server</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN118725"
></A
><H2
>说明</H2
>bool <B
CLASS="methodname"
>Memcache::set</B
> ( string key, mixed var [, int flag [, int expire]] )<BR
></BR
><P
>&#13;   <B
CLASS="function"
>Memcache::set()</B
> stores an item 
   <CODE
CLASS="parameter"
>var</CODE
> with <CODE
CLASS="parameter"
>key</CODE
> on the 
   memcached server. Parameter <CODE
CLASS="parameter"
>expire</CODE
> is expiration 
   time in seconds. If it's 0, the item never expires (but memcached server 
   doesn't guarantee this item to be stored all the time, it could be deleted 
   from the cache to make place for other items).
   You can use <TT
CLASS="constant"
><B
>MEMCACHE_COMPRESSED</B
></TT
> constant as 
   <CODE
CLASS="parameter"
>flag</CODE
> value if you want to use on-the-fly
   compression (uses zlib).
   <DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
     Remember that resource variables (i.e. file and connection descriptors)
     cannot be stored in the cache, because they cannot be adequately
     represented in serialized state.
    </P
></BLOCKQUOTE
></DIV
>
   Also you can use <B
CLASS="function"
>memcache_set()</B
> function.
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN118752"
></A
><H2
>参数</H2
><P
>&#13;   <P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><CODE
CLASS="parameter"
>key</CODE
></DT
><DD
><P
>&#13;       The key that will be associated with the item.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>var</CODE
></DT
><DD
><P
>&#13;       The variable to store. Strings and integers are stored as is, other
       types are stored serialized.
      </P
></DD
><DT
><CODE
CLASS="parameter"
>flag</CODE
></DT
><DD
><P
>&#13;       Use <TT
CLASS="constant"
><B
>MEMCACHE_COMPRESSED</B
></TT
> to store the item
       compressed (uses zlib).
      </P
></DD
><DT
><CODE
CLASS="parameter"
>expire</CODE
></DT
><DD
><P
>&#13;       Expiration time of the item. If it's equal to zero, the item will never
       expire. You can also use Unix timestamp or a number of seconds starting
       from current time, but in the latter case the number of seconds may not
       exceed 2592000 (30 days).
      </P
></DD
></DL
></DIV
>
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN118777"
></A
><H2
>返回值</H2
><P
>&#13;   如果成功则返回 <TT
CLASS="constant"
><B
>TRUE</B
></TT
>,失败则返回 <TT
CLASS="constant"
><B
>FALSE</B
></TT
>。
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN118782"
></A
><H2
>范例</H2
><P
>&#13;   <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN118785"
></A
><P
><B
>例 1. <B
CLASS="function"
>Memcache::set()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">/* procedural API */<br /><br />/* connect to memcached server */<br /></font><font color="#0000BB">$memcache_obj </font><font color="#007700">= </font><font color="#0000BB">memcache_connect</font><font color="#007700">(</font><font color="#DD0000">'memcache_host'</font><font color="#007700">, </font><font color="#0000BB">11211</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/*<br />set value of item with key 'var_key'<br />using 0 as flag value, compression is not used<br />expire time is 30 seconds<br />*/<br /></font><font color="#0000BB">memcache_set</font><font color="#007700">(</font><font color="#0000BB">$memcache_obj</font><font color="#007700">, </font><font color="#DD0000">'var_key'</font><font color="#007700">, </font><font color="#DD0000">'some variable'</font><font color="#007700">, </font><font color="#0000BB">0</font><font color="#007700">, </font><font color="#0000BB">30</font><font color="#007700">);<br /><br />echo </font><font color="#0000BB">memcache_get</font><font color="#007700">(</font><font color="#0000BB">$memcache_obj</font><font color="#007700">, </font><font color="#DD0000">'var_key'</font><font color="#007700">);<br /><br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
   <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN118789"
></A
><P
><B
>例 2. <B
CLASS="function"
>Memcache::set()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">/* OO API */<br /><br /></font><font color="#0000BB">$memcache_obj </font><font color="#007700">= new </font><font color="#0000BB">Memcache</font><font color="#007700">;<br /><br /></font><font color="#FF8000">/* connect to memcached server */<br /></font><font color="#0000BB">$memcache_obj</font><font color="#007700">-&gt;</font><font color="#0000BB">connect</font><font color="#007700">(</font><font color="#DD0000">'memcache_host'</font><font color="#007700">, </font><font color="#0000BB">11211</font><font color="#007700">);<br /><br /></font><font color="#FF8000">/*<br />set value of item with key 'var_key', using on-the-fly compression<br />expire time is 50 seconds<br />*/<br /></font><font color="#0000BB">$memcache_obj</font><font color="#007700">-&gt;</font><font color="#0000BB">set</font><font color="#007700">(</font><font color="#DD0000">'var_key'</font><font color="#007700">, </font><font color="#DD0000">'some really big variable'</font><font color="#007700">, </font><font color="#0000BB">MEMCACHE_COMPRESSED</font><font color="#007700">, </font><font color="#0000BB">50</font><font color="#007700">);<br /><br />echo </font><font color="#0000BB">$memcache_obj</font><font color="#007700">-&gt;</font><font color="#0000BB">get</font><font color="#007700">(</font><font color="#DD0000">'var_key'</font><font color="#007700">);<br /><br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN118793"
></A
><H2
>参见</H2
><P
>&#13;   <P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><B
CLASS="function"
>Memcache::add()</B
></TD
></TR
><TR
><TD
><B
CLASS="function"
>Memcache::replace()</B
></TD
></TR
></TBODY
></TABLE
><P
></P
>
  </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.memcache-replace.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>起始页</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.memcache-setcompressthreshold.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Memcache::replace</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.memcache.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Memcache::setCompressThreshold</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>