©
本文档使用 PHP中文网手册 发布
(PHP 4, PHP 5, PHP 7)
imap_check — Check current mailbox
$imap_stream
)Checks information about the current mailbox.
imap_stream
由 imap_open() 返回的 IMAP 流。
Returns the information in an object with following properties:
Date
- current system time formatted according to » RFC2822 Driver
- protocol used to access this mailbox:
POP3, IMAP, NNTP Mailbox
- the mailbox name
Nmsgs
- number of messages in the mailbox
Recent
- number of recent messages in the mailbox
Returns FALSE
on failure.
Example #1 imap_check() example
<?php
$imap_obj = imap_check ( $imap_stream );
var_dump ( $imap_obj );
?>
以上例程的输出类似于:
object(stdClass)(5) { ["Date"]=> string(37) "Wed, 10 Dec 2003 17:56:54 +0100 (CET)" ["Driver"]=> string(4) "imap" ["Mailbox"]=> string(54) "{www.example.com:143/imap/user="foo@example.com"}INBOX" ["Nmsgs"]=> int(1) ["Recent"]=> int(0) }
[#1] JUNIOR TELLO [2006-01-27 06:43:14]
You can NOT prevent imap_check from flagging new/recent messages when using POP3 enabling the "/readonly" or OP_READONLY flags or options.
[#2] erik at phpcastle dot com [2005-12-13 07:49:52]
The imap_check ($stream); function will return real-time information about the e-mail box (at least imap) during one connection :)
[#3] [2004-10-28 12:21:55]
You can prevent imap_check from flagging new/recent messages as checked by calling imap_open with the "/readonly" or OP_READONLY flags.
[#4] rasmus at flajm dot com [2003-12-18 20:06:25]
Running this on a mailbox will mark recent/new messages as checked.