[ 永遠的UNIX > PHP4手冊:函數庫及函數(二十) IMAP 電子郵件系統函式庫 ]

[ 永遠的UNIX::UNIX技術資料的寶庫 ] GB | BIG5

首頁 > 編程技術 > Php > 正文

PHP4手冊:函數庫及函數(二十) IMAP 電子郵件系統函式庫

http://netleader.126.com 星空浪子 (2001-04-18 13:58:23)

--------------------------------------------------------------------------------
　IMAP　電子郵件系統函式庫　
--------------------------------------------------------------------------------
　

本函式庫共有　46　個函式
IMAP　的全名是　Internet　Message　Access　Protocol，即網際網路訊息存取協定，為美國史丹福大學　(Stanford　University)　在　1986　年開始研發的多重郵箱電子郵件系統。PHP　所提供的功能是　IMAP　4　的系統，這是根據　RFC　1730　所實作的。更多有關　IMAP　的資訊可以參考　IMAP　的官方網站　http://www.imap.org。　
欲使用　IMAP　的電子郵件功能，要先到　ftp://ftp.cac.washington.edu/imap　下載　IMAP　的客戶端程式。在編譯完成之將　c-client/c-client.a　復制到　/usr/local/lib　之中，並將　c-client/rfc822.h、mail.h　及　linkage.h　三個檔案復制到　/usr/local/include　之下。之編譯　PHP　程式時要加入　--with-imap　的選項。　
　

imap_append:　附加字串到指定的郵箱中。　
imap_base64:　解　BASE64　編碼。　
imap_body:　讀信的內文。　
imap_check:　傳回郵箱資訊。　
imap_close:　關閉　IMAP　連結。　
imap_createmailbox:　建立新的信箱。　
imap_delete:　標記欲刪除郵件。　
imap_deletemailbox:　刪除既有信箱。　
imap_expunge:　刪除已標記的郵件。　
imap_fetchbody:　從信件內文取出指定區段。　
imap_fetchstructure:　獲取某信件的結構資訊。　
imap_header:　獲取某信件的標頭資訊。　
imap_headers:　獲取全部信件的標頭資訊。　
imap_listmailbox:　獲取郵箱列示。　
imap_listsubscribed:　獲取訂閱郵箱列示。　
imap_mail_copy:　復制指定信件到它處郵箱。　
imap_mail_move:　移動指定信件到它處郵箱。　
imap_num_msg:　取得信件數。　
imap_num_recent:　取得新進信件數。　
imap_open:　開啟　IMAP　連結。　
imap_ping:　檢查　IMAP　是否連線。　
imap_renamemailbox:　更改郵箱名字。　
imap_reopen:　重開　IMAP　連結。　
imap_subscribe:　訂閱郵箱。　
imap_undelete:　取消刪除郵件標記。　
imap_unsubscribe:　取消訂閱郵箱。　
imap_qprint:　將　qp　編碼轉成八位元。　
imap_8bit:　將八位元轉成　qp　編碼。　
imap_binary:　將八位元轉成　base64　編碼。　
imap_scanmailbox:　尋找信件有無特定字串。　
imap_mailboxmsginfo:　取得目前郵箱的資訊。　
imap_rfc822_write_address:　電子郵件位址標準化。　
imap_rfc822_parse_adrlist:　剖析電子郵件位址。　
imap_setflag_full:　設定信件旗標。　
imap_clearflag_full:　清除信件旗標。　
imap_sort:　將信件標頭排序。　
imap_fetchheader:　取得原始標頭。　
imap_uid:　取得信件　UID。　
imap_getmailboxes:　取得全部信件詳細資訊。　
imap_getsubscribed:　列出所有訂閱郵箱。　
imap_msgno:　列出　UID　的連續信件。　
imap_search:　搜尋指定標準的信件。　
imap_last_error:　最的錯誤訊息。　
imap_errors:　所有的錯誤訊息。　
imap_alerts:　所有的警告訊息。　
imap_status:　目前的狀態資訊。　

--------------------------------------------------------------------------------
　函式:imap_append()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_append
附加字串到指定的郵箱中。

語法:　int　imap_append(int　imap_stream,　string　mbox,　string　message,　string　[flags]);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式可在指定的電子郵箱中增加附加的字串。參數　imap_stream　為　IMAP　的代號。參數　mbox　為電子郵箱的位址。參數　message　為欲附加的訊息。參數　flag　為可省略的旗標，表示電子郵箱的旗標值。值得注意的是要與　Cyrus　IMAP　伺服器溝通時，應使用　\r\n　作為行結束字元　(end-of-line,　EOL)。若有錯誤則傳回　false　值。
　
函式:imap_base64()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_base64
解　BASE64　編碼。

語法:　string　imap_base64(string　text);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式可將用　BASE64　編碼字串解碼。傳回值是解碼的字串。

　
　
參考　

imap_binary()　　base64_encode()　　base64_decode()　　
　

--------------------------------------------------------------------------------
　函式:imap_body()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_body
讀信的內文。

語法:　string　imap_body(int　imap_stream,　int　msg_number,　int　[flags]);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式可讀取信件的內文　(body)　部份。參數　imap_stream　為　IMAP　的代號。參數　msg_number　為信件的序號。參數　flags　可省略，有下列的值

FT_UID　:　信件序號為　UID。　
FT_PEEK　:　若無設定　\Seen　旗標則不要設本旗標。　
FT_INTERNAL　:　傳回字串使用系統格式，不要刻意轉成　CRLF　行結束標準。　

　
　
使用范例　

本例利用　IMAP　協定讀取　myid@localhost　的第一封信件。

$mbox　=　imap_open("{localhost:143}INBOX","myid","mypw");
$message　=　imap_body($mbox,　1);
imap_close($mbox);
echo　$message;
?>　

--------------------------------------------------------------------------------
　函式:imap_check()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_check
傳回郵箱資訊。

語法:　object　imap_check(int　imap_stream);

傳回值:　物件

函式種類:　網路系統

　
　
內容說明　

本函式可取得目前電子郵箱的資訊。傳回值為物件型態，包含下面的屬性

物件屬性　代表意義說明　
Date　最新郵件的日期　
Driver　使用的介面　
Mailbox　電子郵箱網址　
Nmsgs　總郵件數目　
Recent　新進郵件數目　

　
　
參考　

imap_mailboxmsginfo()　　

　

--------------------------------------------------------------------------------
　函式:imap_close()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_close
關閉　IMAP　連結。

語法:　int　imap_close(int　imap_stream,　int　[flags]);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式用來關閉　IMAP　的資料流，亦即結束連結。可省略的參數　flags　的值若為　CL_EXPUNGE　則在關閉連結前會將電子郵件信箱清空。

　

--------------------------------------------------------------------------------
　函式:imap_createmailbox()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_createmailbox
建立新的信箱。

語法:　int　imap_createmailbox(int　imap_stream,　string　mbox);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式用來建立新的信箱。成功則傳回　true　值。

--------------------------------------------------------------------------------
　函式:imap_delete()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_delete
標記欲刪除郵件。

語法:　int　imap_delete(int　imap_stream,　int　msg_number);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式僅用來標記欲刪除之郵件。實際刪除的指令　imap_expunge()
　

--------------------------------------------------------------------------------
　函式:imap_deletemailbox()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_deletemailbox
刪除既有信箱。

語法:　int　imap_deletemailbox(int　imap_stream,　string　mbox);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式用來刪除既有的信箱。成功則傳回　true　值。
　

--------------------------------------------------------------------------------
　函式:imap_expunge()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_expunge
刪除已標記的郵件。

語法:　int　imap_expunge(int　imap_stream);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式用來刪除已加入刪除標記的郵件。欲標記郵件須使用　imap_delete()　函式。
　

--------------------------------------------------------------------------------
　函式:imap_fetchbody()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_fetchbody
從信件內文取出指定區段。

語法:　string　imap_fetchbody(int　imap_stream,　int　msg_number,　string　part_number,　flags　[flags]);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式可讀取信件的內文　(body)　部份。參數　imap_stream　為　IMAP　的代號。參數　msg_number　為信件的序號。參數　part_number　為指定的區段。參數　flags　可省略，有下列的值

FT_UID　:　信件序號為　UID。　
FT_PEEK　:　若無設定　\Seen　旗標則不要設本旗標。　
FT_INTERNAL　:　傳回字串使用系統格式，不要刻意轉成　CRLF　行結束標準。　
　

--------------------------------------------------------------------------------
　函式:imap_fetchstructure()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_fetchstructure
獲取某信件的結構資訊。

語法:　array　imap_fetchstructure(int　imap_stream,　int　msg_number);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函式可讀取指定信件的相關資訊。參數　imap_stream　為　IMAP　的代號。參數　msg_number　為信件的序號。傳回的資訊為陣列的方式，各元素的內容見下表

元素名稱　型態　
type　整數　(Integer)　
encoding　整數　(Integer)　
ifsubtype　布林　(Boolean)　
subtype　字串　(String)　
ifdescription　布林　(Boolean)　
description　字串　(String)　
ifid　布林　(Boolean)　
id　字串　(String)　
lines　整數　(Integer)　
bytes　整數　(Integer)　
ifparameters　布林　(Boolean)　

其中　type　元素的值代表的意義如下

值　代表意義　
0　文字　text　
1　復合　multipart　
2　訊息　message　
3　程式　application　
4　聲音　audio　
5　圖形　image　
6　影像　video　
7　其它　other　

而　encoding　值代表的意義如下

值　代表意義　
0　七位元　(7　bit)　
1　八位元　(8　bit)　
2　二進位　(binary)　
3　BASE64　編碼　
4　QP　編碼　(QuotedPrintable)　
5　其它　

--------------------------------------------------------------------------------
　函式:imap_header()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_header
獲取某信件的標頭資訊。

語法:　object　imap_header(int　imap_stream,　int　msg_number,　int　[fromlength],　int　[subjectlength],　int　[defaulthost]);

傳回值:　物件

函式種類:　網路系統

　
　
內容說明　

本函式可讀取指定信件的標頭資訊。參數　msg_number　為信件的序號。傳回物件有下列的屬性：Answered、bcc、bccaddress、cc、ccaddress、Date、date、Deleted、fetchfrom、fetchsubject、Flagged、followup_to、from、fromaddress、in_reply_to、MailDate、message_id、Msgno、newsgroups、Recent、references、remail、reply_to、reply_toaddress、return_path、return_pathaddress、sender、senderaddress、Size、Subject、subject、to、toaddress、udate、Unseen。
　

--------------------------------------------------------------------------------
　函式:imap_headers()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_headers
獲取全部信件的標頭資訊。

語法:　array　imap_headers(int　imap_stream);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函式可讀取全部信件的標頭資訊。參數　imap_stream　為　IMAP　的代號。傳回的陣列一個元素為某一封信的標頭。

　
　
使用范例　

$mb　=　imap_open("{my.imap.com.tw}INBOX",　"wilson",　"mypasswd");
$AllHeaders　=　imap_headers($mb);
imap_close($mb);
echo　"

\n";

for　($i=0;　$i　<　count($AllHeaders);　$i++)　{

　　echo　$AllHeaders[$i]."
\n";

}

echo　"

\n";
?>　
　

--------------------------------------------------------------------------------
　函式:imap_listmailbox()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_listmailbox
獲取郵箱列示。

語法:　array　imap_listmailbox(int　stream_id,　string　ref,　string　pattern);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函式可獲得郵箱列示。參數　imap_stream　為　IMAP　的代號。參數　ref　通常為　IMAP　伺服器名稱，參考下例。參數　pattern　可用萬用字元　*　代表全部的路徑，aayawa@yahoo.com　並指出　(27-Apr-1999)　若本參數以　""　(空字元)　代入，不會傳回資料。

　
　
使用范例　

本例為　alank@shermanloan.com　　02-Jun-1999　所提出的。

$Account　=　"myid";
$Password=　"mypasswd";
$mailbox　=　imap_open("{mail.xyz.com:143}INBOX",　$Account,　$Password);
if　($mailbox)　{
　　$mailboxes　=　imap_listmailbox($mailbox,　"{mail.xyz.com:143}",　"*");
　　for　($index　=　0;　$index　<　count($mailboxes);　$index++)　{
　　　　print($mailboxes[$index]　.　"\n");
　　}
　　imap_close($mailbox);
}　else　{
　　print("無法?/font>}啟　$Account　的信箱.\n");
}
?>　

--------------------------------------------------------------------------------
　函式:imap_listsubscribed()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_listsubscribed
獲取訂閱郵箱列示。

語法:　array　imap_listsubscribed(int　stream_id,　string　ref,　string　pattern);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函式可獲得訂閱郵箱　(subscribed)　列示。參數　imap_stream　為　IMAP　的代號。參數　ref　通常為　IMAP　伺服器名稱。參數　pattern　可用萬用字元　*　代表全部的路徑。

　
　
參考　

imap_listmailbox()　　imap_subscribe()　　imap_unsubscribe()　　
　

--------------------------------------------------------------------------------
　函式:imap_mail_copy()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_mail_copy
復制指定信件到它處郵箱。

語法:　int　imap_mail_copy(int　imap_stream,　string　msglist,　string　mbox,　int　[flags]);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式復制指定的信件到指定的郵箱　(mailbox)　之中。參數　imap_stream　為　IMAP　的代號。參數　msglist　可以是信件號序，也可以是范圍。參數　mbox　為復制的目的郵箱。參數　flags　可省略，有二種選擇　CP_UID，CP_MOVE。
　

--------------------------------------------------------------------------------
　函式:imap_mail_move()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_mail_move
移動指定信件到它處郵箱。

語法:　int　imap_mail_move(int　imap_stream,　string　msglist,　string　mbox);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式移動指定的信件到指定的郵箱　(mailbox)　之中。參數　imap_stream　為　IMAP　的代號。參數　msglist　可以是信件號序，也可以是范圍。參數　mbox　為移動的目的郵箱。
　

--------------------------------------------------------------------------------
　函式:imap_num_msg()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_num_msg
取得信件數。

語法:　int　imap_num_msg(int　imap_stream);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式可取得郵箱　(mailbox)　的信件數。參數　imap_stream　為　IMAP　的代號。

　

--------------------------------------------------------------------------------
　函式:imap_num_recent()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_num_recent
取得新進信件數。

語法:　int　imap_num_recent(int　imap_stream);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式可取得郵箱　(mailbox)　的新進未讀信件數。參數　imap_stream　為　IMAP　的代號
　

--------------------------------------------------------------------------------
　函式:imap_open()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_open
開啟　IMAP　連結。

語法:　int　imap_open(string　mailbox,　string　username,　string　password,　int　[flags]);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式可打開客戶端與伺服器之間的　IMAP　連結，並可連結至　POP3　或　NNTP　伺服器。參數　mailbox　為伺服器端的位置。參數　username　為使用者帳號。參數　password　為使用者的密碼。參數　flags　可省略，有下列的值：

OP_READONLY　:　打開連結使用唯讀狀態。　
OP_ANONYMOUS　:　匿名讀取　NNTP　伺服器，不使用　.newsrc　檔案。　
OP_HALFOPEN　:　只與　IMAP　或　NNTP　伺服器連結，不開啟郵箱。　
CL_EXPUNGE　:　關閉連結時自動清除郵箱中的信件。　

　
　
使用范例　

下例分別為開啟　IMAP、POP3、NNTP　的部份參考范例

$mbox　=　imap_open("{localhost:143}INBOX","user_id","password");
　?/font>}啟與　IMAP　伺服器連結，IMAP　的埠　(port)　通?/font>`為　143。
$mbox　=　imap_open("{localhost/pop3:110}INBOX","user_id","password");
\\　?/font>}啟與　POP3　伺服器連結，POP3　的埠值為　110。
$nntp　=　imap_open("{localhost/nntp:119}comp.test","","");
\\　?/font>}啟與　NNTP　伺服器連結，NNTP　的埠為　119。
?>　

--------------------------------------------------------------------------------
　函式:imap_ping()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_ping
檢查　IMAP　是否連線。

語法:　int　imap_ping(int　imap_stream);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函用來檢查與　IMAP　伺服器的連線狀態。參數　imap_stream　為　IMAP　的代號。若仍然保持與　IMAP　伺服器連線則傳回　true　值。
　

--------------------------------------------------------------------------------
　函式:imap_renamemailbox()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_renamemailbox
更改郵箱名字。

語法:　int　imap_renamemailbox(int　imap_stream,　string　old_mbox,　string　new_mbox);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函用來更改郵箱　(mailbox)　的名字。參數　imap_stream　為　IMAP　的代號。參數　old_mbox　及　new_mbox　分別為原郵箱名字及欲更換成的新郵箱名字。更換成功則傳回　true　值。
　

--------------------------------------------------------------------------------
　函式:imap_reopen()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_reopen
重開　IMAP　連結。

語法:　int　imap_reopen(string　imap_stream,　string　mailbox,　string　[flags]);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式可重新開啟客戶端與伺服器之間的　IMAP　連結。本函式通常與　imap_ping()　函式合用。參數　mailbox　為伺服器端的位置。參數　flags　可省略，有下列的值：

OP_READONLY　:　打開連結使用唯讀狀態。　
OP_ANONYMOUS　:　匿名讀取　NNTP　伺服器，不使用　.newsrc　檔案。　
OP_HALFOPEN　:　只與　IMAP　或　NNTP　伺服器連結，不開啟郵箱。　
CL_EXPUNGE　:　關閉連結時自動清除郵箱中的信件。　

　
　
使用范例　

$userid　=　"nulluser";
$passwd　=　"passwd38";
$mb　=　imap_open("(imap.null.org)INBOX",　$userid,　$passwd);
if　(!imap_ping($mb))　{
　　imap_reopen($mb,　$userid,　$passwd);
}
imap_close($mb);
?>　

--------------------------------------------------------------------------------
　函式:imap_subscribe()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_subscribe
訂閱郵箱。

語法:　int　imap_subscribe(int　imap_stream,　string　mbox);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式可訂閱新郵箱　(mailbox)。
　

--------------------------------------------------------------------------------
　函式:imap_undelete()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_undelete
取消刪除郵件標記。

語法:　int　imap_undelete(int　imap_stream,　int　msg_number);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式將標記欲刪除郵件取消。標記欲刪除郵件需使用　imap_delete()。參數　msg_number　代表郵件的流水序號。
　

--------------------------------------------------------------------------------
　函式:imap_unsubscribe()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_unsubscribe
取消訂閱郵箱。

語法:　int　imap_unsubscribe(int　imap_stream,　string　mbox);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式可取消訂閱新郵箱　(mailbox)。

--------------------------------------------------------------------------------
　函式:imap_qprint()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_qprint
將　qp　編碼轉成八位元。

語法:　string　imap_qprint(string　string);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式可將　QP　(quoted-printable)　編碼字串轉成八位元字串。

　
　
參考　

quoted_printable_decode()　　imap_8bit()　　
　

--------------------------------------------------------------------------------
　函式:imap_8bit()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_8bit
將八位元轉成　qp　編碼。

語法:　string　imap_8bit(string　string);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式可將八位元字串轉成　QP　(quoted-printable)　編碼字串。

　
　
參考　

quoted_printable_decode()　　imap_qprint()　　
　

--------------------------------------------------------------------------------
　函式:imap_binary()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_binary
將八位元轉成　base64　編碼。

語法:　string　imap_binary(string　string);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式將字串轉成　MIME　BASE64　編碼。此編碼方式可以讓中文字或者圖片也能在網路上順利傳輸。更多的　BASE64　編碼資訊可以參考　RFC2045　文件之　6.8　節或是　base64_encode()。

　
　
參考　

imap_base64()　　base64_decode()　　chunk_split()　　
　

--------------------------------------------------------------------------------
　函式:imap_scanmailbox()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_scanmailbox
尋找信件有無特定字串。

語法:　array　imap_scanmailbox(int　imap_stream,　string　ref,　string　pattern,　string　content);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函用來檢查與　IMAP　伺服器信件中有無特定的字串。參數　imap_stream　為　IMAP　的代號。參數　ref　通常為　IMAP　伺服器名稱，如　"{mail.wahaha.com:143}"。參數　pattern　為剖析比對字串的規則。參數　content　則為欲尋找的字串內容。

--------------------------------------------------------------------------------
　
函式:imap_mailboxmsginfo()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_mailboxmsginfo
取得目前郵箱的資訊。

語法:　object　imap_mailboxmsginfo(int　imap_stream);

傳回值:　物件

函式種類:　網路系統

　
　
內容說明　

本函用來取得目前使用中郵箱　(mailbox)　的相關資訊。參數　imap_stream　為　IMAP　的代號。傳回物件包括下列的屬性

物件屬性　代表意義說明　
Date　最新郵件的日期　
Driver　使用的介面　
Mailbox　電子郵箱網址　
Nmsgs　總郵件數目　
Recent　新進郵件數目　
Unread　未讀郵件數目　
Size　郵箱大小　

　
　
參考　

imap_check()　　
　

--------------------------------------------------------------------------------
　函式:imap_rfc822_write_address()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_rfc822_write_address
電子郵件位址標準化。

語法:　string　imap_rfc822_write_address(string　mailbox,　string　host,　string　personal);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式將電子郵件位址成為　rfc822　的標準格式。
　

--------------------------------------------------------------------------------
　函式:imap_rfc822_parse_adrlist()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_rfc822_parse_adrlist
剖析電子郵件位址。

語法:　object　imap_rfc822_parse_adrlist(string　address,　string　default_host);

傳回值:　物件

函式種類:　網路系統

　
　
內容說明　

本函式可剖析電子郵件位址。傳回的物件包括下列屬性

屬性名　說明　
mailbox　使用者名稱　
host　伺服器名稱　
personal　個人名字　
adl　所在來源繞路　

　

--------------------------------------------------------------------------------
　函式:imap_setflag_full()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_setflag_full
設定信件旗標。

語法:　int　imap_setflag_full(int　imap_stream,　string　sequence,　string　flag,　int　[options]);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函式可指定連續信件而設定旗標。參數　imap_stream　為　IMAP　的代號。參數　sequence　為特定的區段序號。參數　flag　為欲設定的旗標值，包括　Seen、Answered、Flagged、Deleted、Draft　及　Recent。參數　options　可省略，可為　ST_UID。
　

--------------------------------------------------------------------------------
　函式:imap_clearflag_full()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_clearflag_full
清除信件旗標。

語法:　imap_clearflag_full(int　imap_stream,　string　sequence,　string　flag,　int　[options]);

傳回值:　無

函式種類:　網路系統

　
　
內容說明　

本函式可指定連續信件而清除旗標。參數　imap_stream　為　IMAP　的代號。參數　sequence　為特定的區段序號。參數　flag　為欲設定的旗標值，包括　Seen、Answered、Flagged、Deleted、Draft　及　Recent。參數　options　可省略，可為　ST_UID。
　

--------------------------------------------------------------------------------
　函式:imap_sort()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_sort
將信件標頭排序。

語法:　array　imap_sort(int　imap_stream,　int　criteria,　int　reverse,　int　[options]);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函式將信件標頭排序。參數　imap_stream　為　IMAP　的代號。參數　criteria　的意義見下表，並只能是下表的其中一項

排序方法　說明　
SORTDATE　依發信日期排序　
SORTARRIVAL　依抵達日期排序　
SORTFROM　依寄件人排序　
SORTSUBJECT　依主題排序　
SORTTO　依收件人排序　
SORTCC　依副本寄送處排序　
SORTSIZE　依信件大小排序　

參數　reverse　值為　0　時表由小到大排序，若值為　1　表由大到小排序。參數　options　可省略，有下列的值:　SE_UID　與　SE_NOPREFETCH。　

--------------------------------------------------------------------------------
　函式:imap_fetchheader()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_fetchheader
取得原始標頭。

語法:　string　imap_fetchheader(int　imap_stream,　int　msg_no,　int　[options]);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式將信件標頭排序。參數　imap_stream　為　IMAP　的代號。參數　msg_no　為信件序號。參數　options　可省略，其值有下列數種

FT_UID　:　信件序號為　UID。　
FT_INTERNAL　:　傳回字串使用系統格式，不要刻意轉成　CRLF　行結束標準。　
FT_PREFETCHTEXT　:　去掉額外的　RTT　

--------------------------------------------------------------------------------
　函式:imap_uid()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_uid
取得信件　UID。

語法:　string　imap_uid(string　mailbox,　int　msgno);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式可取得指定信件的　UID。參數　mailbox　為郵箱名。參數　msgno　為信件序號。

　

--------------------------------------------------------------------------------
　函式:imap_getmailboxes()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_getmailboxes
取得全部信件詳細資訊。

語法:　object　imap_getmailboxes(int　imap_stream,　string　ref,　string　pattern);

傳回值:　物件

函式種類:　網路系統

　
　
內容說明　

本函用來檢查　IMAP　伺服器信件的詳細資訊。參數　imap_stream　為　IMAP　的代號。參數　ref　通常為　IMAP　伺服器名稱，如　"{mail.wahaha.com:143}"。參數　pattern　為剖析比對字串的規則。

--------------------------------------------------------------------------------
　函式:imap_getsubscribed()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_getsubscribed
列出所有訂閱郵箱。

語法:　array　imap_getsubscribed(int　imap_stream,　string　ref,　string　pattern);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函用來列示出所有訂閱　IMAP　伺服器信箱　(mailbox)。參數　imap_stream　為　IMAP　的代號。參數　ref　通常為　IMAP　伺服器名稱，如　"{mail.wahaha.com:143}"。參數　pattern　為剖析比對字串的規則。
　

--------------------------------------------------------------------------------
　函式:imap_msgno()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_msgno
列出　UID　的連續信件。

語法:　int　imap_msgno(int　imap_stream,　int　uid);

傳回值:　整數

函式種類:　網路系統

　
　
內容說明　

本函用來列示指定　UID　的連續信件。參數　imap_stream　為　IMAP　的代號。參數　UID　為使用者代號。
　

--------------------------------------------------------------------------------
　函式:imap_search()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_search
搜尋指定標準的信件。

語法:　array　imap_search(int　imap_stream,　string　criteria,　int　flags);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函用來搜尋合乎指定條件的信件。參數　imap_stream　為　IMAP　的代號。參數　criteria　為指定的條件，各欄位以空格　(space)　分開，條件見下表。參數　flags　為　SE_UID。

條件　說明　
ALL　傳回所有合乎標準的信件　
ANSWERED　信件有設定　\\ANSWERED　旗標者　
BCC　"字串"　Bcc　欄中有指定　"字串"　的信件　
BEFORE　"日期"　指定　"日期"　以前的信件　
BODY　"字串"　內文欄位中有指定　"字串"　的信件　
CC　"字串"　Cc　欄中有指定　"字串"　的信件　
DELETED　合乎已刪除的信件　
FLAGGED　信件有設定　\\FLAGGED　旗標者　
FROM　"字串"　From　欄中有指定　"字串"　的信件　
KEYWORD　"字串"　關鍵字為指定　"字串"　者　
NEW　新的信件　
OLD　舊的信件　
ON　"日期"　指定　"日期"　的信件　
RECENT　信件有設定　\\RECENT　旗標者　
SEEN　信件有設定　\\SEEN　旗標者　
SINCE　"日期"　指定　"日期"　之的信件　
SUBJECT　"字串"　Subject　欄中有指定　"字串"　的信件　
TEXT　"字串"　Text　欄中有指定　"字串"　的信件　
TO　"字串"　To　欄中有指定　"字串"　的信件　
UNANSWERED　未回應的信件　
UNDELETED　未刪除的信件　
UNFLAGGED　未設定旗標的信件　
UNKEYWORD　"字串"　未設定關鍵　"字串"　的信件　
UNSEEN　未讀取的信件　

--------------------------------------------------------------------------------
　函式:imap_last_error()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_last_error
最的錯誤訊息。

語法:　string　imap_last_error(void);

傳回值:　字串

函式種類:　網路系統

　
　
內容說明　

本函式用來顯示最出現的　IMAP　錯誤字串。本函式不需要使用任何參數。

　

--------------------------------------------------------------------------------
　函式:imap_errors()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_errors
所有的錯誤訊息。

語法:　array　imap_errors(void);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函式用來顯示所有出現的　IMAP　錯誤字串。本函式不需要使用任何參數。
　

--------------------------------------------------------------------------------
　函式:imap_alerts()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_alerts
所有的警告訊息。

語法:　array　imap_alerts(void);

傳回值:　陣列

函式種類:　網路系統

　
　
內容說明　

本函式用來顯示所有出現的　IMAP　警告字串。本函式不需要使用任何參數。
　

--------------------------------------------------------------------------------
　函式:imap_status()　
--------------------------------------------------------------------------------
　

IMAP　電子郵件系統函式庫

imap_status
目前的狀態資訊。

語法:　object　imap_status(int　imap_stream,　string　mailbox,　int　options);

傳回值:　物件

函式種類:　網路系統

　
　
內容說明　

本函式用來顯示目前　IMAP　的狀態資訊。參數　imap_stream　為　IMAP　的代號。參數　mailbox　為指定的郵箱。參數　options　有下面的選擇：SA_MESSAGES、SA_RECENT、SA_UNSEEN、SA_UIDNEXT、SA_UIDVALIDITY　與　SA_ALL。 (http://www.fanqiang.com) 進入【UNIX論壇】

===更多相關===

★ 樊強制作歡迎分享 ★