Sophie

Sophie

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

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
>imap_get_quota</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="IMAP, POP3 and NNTP Functions"
HREF="ref.imap.html"><LINK
REL="PREVIOUS"
TITLE="imap_fetchstructure"
HREF="function.imap-fetchstructure.html"><LINK
REL="NEXT"
TITLE="imap_get_quotaroot"
HREF="function.imap-get-quotaroot.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.imap-fetchstructure.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.imap-get-quotaroot.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.imap-get-quota"
></A
>imap_get_quota</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN96403"
></A
><P
>    (PHP 4 &#62;= 4.0.5, PHP 5)</P
>imap_get_quota&nbsp;--&nbsp;Retrieve the quota level settings, and usage statics per mailbox</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN96406"
></A
><H2
>说明</H2
>array <B
CLASS="methodname"
>imap_get_quota</B
> ( resource imap_stream, string quota_root )<BR
></BR
><P
>&#13;   Retrieve the quota level settings, and usage statics per mailbox.
  </P
><P
>&#13;   For a non-admin user version of this function,
   please see the <A
HREF="function.imap-get-quotaroot.html"
><B
CLASS="function"
>imap_get_quotaroot()</B
></A
> function of PHP.
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN96420"
></A
><H2
>参数</H2
><P
>&#13;   <P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><CODE
CLASS="parameter"
>&#13;imap_stream</CODE
></DT
><DD
><P
>An IMAP stream returned by 
<A
HREF="function.imap-open.html"
><B
CLASS="function"
>imap_open()</B
></A
>.</P
></DD
><DT
><CODE
CLASS="parameter"
>quota_root</CODE
></DT
><DD
><P
>&#13;       <CODE
CLASS="parameter"
>quota_root</CODE
> should normally be in the form of
       <TT
CLASS="literal"
>user.name</TT
> where name is the mailbox you wish to
       retrieve information about.
      </P
></DD
></DL
></DIV
>
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN96437"
></A
><H2
>返回值</H2
><P
>&#13;   Returns an array with integer values limit and usage for the given
   mailbox.  The value of limit represents the total amount of space
   allowed for this mailbox.  The usage value represents the mailboxes
   current level of capacity.  Will return <TT
CLASS="constant"
><B
>FALSE</B
></TT
> in the case of failure.
  </P
><P
>&#13;   As of PHP 4.3, the function more properly reflects the
   functionality as dictated by the <A
HREF="http://www.faqs.org/rfcs/rfc2087"
TARGET="_top"
>RFC2087</A
>.
   The array return value has changed to support an unlimited number of returned 
   resources (i.e.  messages, or sub-folders) with each named resource receiving
   an individual array key.  Each key value then contains an another array with
   the usage and limit values within it.
  </P
><P
>&#13;   For backwards compatibility reasons, the original access methods are
   still available for use, although it is suggested to update.
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN96444"
></A
><H2
>范例</H2
><P
>&#13;   <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN96447"
></A
><P
><B
>例 1. <B
CLASS="function"
>imap_get_quota()</B
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$mbox </font><font color="#007700">= </font><font color="#0000BB">imap_open</font><font color="#007700">(</font><font color="#DD0000">"{imap.example.org}"</font><font color="#007700">, </font><font color="#DD0000">"mailadmin"</font><font color="#007700">, </font><font color="#DD0000">"password"</font><font color="#007700">, </font><font color="#0000BB">OP_HALFOPEN</font><font color="#007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;or die(</font><font color="#DD0000">"can't connect: " </font><font color="#007700">. </font><font color="#0000BB">imap_last_error</font><font color="#007700">());<br /><br /></font><font color="#0000BB">$quota_value </font><font color="#007700">= </font><font color="#0000BB">imap_get_quota</font><font color="#007700">(</font><font color="#0000BB">$mbox</font><font color="#007700">, </font><font color="#DD0000">"user.kalowsky"</font><font color="#007700">);<br />if (</font><font color="#0000BB">is_array</font><font color="#007700">(</font><font color="#0000BB">$quota_value</font><font color="#007700">)) {<br />&nbsp;&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">"Usage level is: " </font><font color="#007700">. </font><font color="#0000BB">$quota_value</font><font color="#007700">[</font><font color="#DD0000">'usage'</font><font color="#007700">];<br />&nbsp;&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">"Limit level is: " </font><font color="#007700">. </font><font color="#0000BB">$quota_value</font><font color="#007700">[</font><font color="#DD0000">'limit'</font><font color="#007700">];<br />}<br /><br /></font><font color="#0000BB">imap_close</font><font color="#007700">(</font><font color="#0000BB">$mbox</font><font color="#007700">);<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
  </P
><P
>&#13;   <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN96452"
></A
><P
><B
>例 2. <B
CLASS="function"
>imap_get_quota()</B
> 4.3 or greater example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br />$mbox </font><font color="#007700">= </font><font color="#0000BB">imap_open</font><font color="#007700">(</font><font color="#DD0000">"{imap.example.org}"</font><font color="#007700">, </font><font color="#DD0000">"mailadmin"</font><font color="#007700">, </font><font color="#DD0000">"password"</font><font color="#007700">, </font><font color="#0000BB">OP_HALFOPEN</font><font color="#007700">)<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;or die(</font><font color="#DD0000">"can't connect: " </font><font color="#007700">. </font><font color="#0000BB">imap_last_error</font><font color="#007700">());<br /><br /></font><font color="#0000BB">$quota_values </font><font color="#007700">= </font><font color="#0000BB">imap_get_quota</font><font color="#007700">(</font><font color="#0000BB">$mbox</font><font color="#007700">, </font><font color="#DD0000">"user.kalowsky"</font><font color="#007700">);<br />if (</font><font color="#0000BB">is_array</font><font color="#007700">(</font><font color="#0000BB">$quota_values</font><font color="#007700">)) {<br />&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">$storage </font><font color="#007700">= </font><font color="#0000BB">$quota_values</font><font color="#007700">[</font><font color="#DD0000">'STORAGE'</font><font color="#007700">];<br />&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">"STORAGE usage level is: " </font><font color="#007700">.&nbsp;&nbsp;</font><font color="#0000BB">$storage</font><font color="#007700">[</font><font color="#DD0000">'usage'</font><font color="#007700">];<br />&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">"STORAGE limit level is: " </font><font color="#007700">.&nbsp;&nbsp;</font><font color="#0000BB">$storage</font><font color="#007700">[</font><font color="#DD0000">'limit'</font><font color="#007700">];<br /><br />&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">$message </font><font color="#007700">= </font><font color="#0000BB">$quota_values</font><font color="#007700">[</font><font color="#DD0000">'MESSAGE'</font><font color="#007700">];<br />&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">"MESSAGE usage level is: " </font><font color="#007700">.&nbsp;&nbsp;</font><font color="#0000BB">$message</font><font color="#007700">[</font><font color="#DD0000">'usage'</font><font color="#007700">];<br />&nbsp;&nbsp;&nbsp;echo </font><font color="#DD0000">"MESSAGE limit is: " </font><font color="#007700">.&nbsp;&nbsp;</font><font color="#0000BB">$message</font><font color="#007700">[</font><font color="#DD0000">'limit'</font><font color="#007700">];<br /><br />&nbsp;&nbsp;&nbsp;</font><font color="#FF8000">/* ...&nbsp;&nbsp;*/<br /></font><font color="#007700">}<br /><br /></font><font color="#0000BB">imap_close</font><font color="#007700">(</font><font color="#0000BB">$mbox</font><font color="#007700">);<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN96456"
></A
><H2
>注释</H2
><P
>&#13;   This function is currently only available to users of the c-client2000
   or greater library.
  </P
><P
>&#13;   The given <CODE
CLASS="parameter"
>imap_stream</CODE
> must be opened as the mail
   administrator, other wise this function will fail.
  </P
></DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN96461"
></A
><H2
>参见</H2
><P
>&#13;   <P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><A
HREF="function.imap-open.html"
><B
CLASS="function"
>imap_open()</B
></A
></TD
></TR
><TR
><TD
><A
HREF="function.imap-set-quota.html"
><B
CLASS="function"
>imap_set_quota()</B
></A
></TD
></TR
><TR
><TD
><A
HREF="function.imap-get-quotaroot.html"
><B
CLASS="function"
>imap_get_quotaroot()</B
></A
></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.imap-fetchstructure.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.imap-get-quotaroot.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>imap_fetchstructure</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.imap.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>imap_get_quotaroot</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional