常用IMAP命令Word格式文档下载.docx
《常用IMAP命令Word格式文档下载.docx》由会员分享，可在线阅读，更多相关《常用IMAP命令Word格式文档下载.docx（22页珍藏版）》请在冰豆网上搜索。
A683OKRENAMEcompleted
A684RENAMEstuff/junknewbox/*把stuff目录（文件夹）下的邮箱junk改名为newbox*/
A684OKRENAMECompleted
4．
LIST<
BASE>
template>
LIST命令用于列出邮箱中已有的文件夹，有点像操作系统的列目录命令，有两个参数，邮箱路径参数BASE：
表示用户登陆目录；
第二个参数template：
表示希望显示的邮箱名。
这个命令可以包含起始的路径位置和需要列出的文件夹所符合的特征，可以使用通配符"
*"
。
A101LIST"
"
"
*LIST（\Noselect）"
/"
A101OKLISTCompleted
A102LIST#p.mail.misc"
."
#news.
A102OKLISTCompleted
A103LIST/usr/staff/jones"
/
A103OKLISTCompleted
A202LIST~/Mail/%
~/Mail/foo
*LIST（）"
~/Mail/meetings
A202OKLISTcompleted
5．
APPEND<
attributes>
date/time>
size>
maildata>
APPEND命令允许Client上载一个邮件到指定的Folder（文件夹/邮箱）中。
命令中包含了新邮件的属性、日期/时间、大小，随后是邮件数据。
A003APPENDsaved-messages（\Seen）{310}
Date:
Mon，7Feb199421:
52:
25-0800（PST）
From:
FredFoobar<
**********************>
Subject:
afternoonmeeting
To:
******************.edu
Message-Id:
******************************>
MIME-Version:
1.0
Content-Type:
TEXT/PLAIN;
CHARSET=US-ASCII
HelloJoe，doyouthinkwecanmeetat3:
30tomorrow?
A003OKAPPENDcompleted
6．
SELECT<
SELECT命令让Client选定某个邮箱（Folder），表示即将对该邮箱（Folder）内的邮件作操作。
邮箱标志的当前状态也返回给了用户，同时返回的还有一些关于邮件和邮箱的附加信息。
A142SELECTINBOX
*172EXISTS
*1RECENT
*OK[UNSEEN12]Message12isfirstunseen
*OK[UIDVALIDITY3857529045]UIDsvalid
*FLAGS（\Answered\Flagged\Deleted\Seen\Draft）
*OK[PERMANENTFLAGS（\Deleted\Seen\*）]Limited
A142OK[READ-WRITE]SELECTcompleted
7．
FETCH<
mailid>
datanames>
FETCH命令用于读取邮件的文本信息，且仅用于显示的目的。
包含两个参数，messageset：
表示希望读取的邮件号列表，IAMP服务器邮箱中的每个邮件都有一个唯一的ID标识，（邮件号列表参数可以是一个邮件号，也可以是由逗号分隔的多个邮件号，或者由冒号间隔的一个范围），IMAP服务器返回邮件号列表中全部邮件的指定数据项内容。
数据名参数确定能够被独立返回的邮件的一部分，下面我们看看各参数返回的邮件信息：
ALL：
只返回按照一定格式的邮件摘要，包括邮件标志、RFC822.SIZE、自身的时间和信封信息。
IMAP客户机能够将标准邮件解析成这些信息并显示出来。
BODY：
只返回邮件体文本格式和大小的摘要信息。
IMAP客户机可以识别这些细腻，并向用户显示详细的关于邮件的信息。
其实是一些非扩展的BODYSTRUCTURE的信息。
FAST：
只返回邮件的一些摘要，包括邮件标志、RFC822.SIZE、和自身的时间。
FULL：
同样的还是一些摘要信息，包括邮件标志、RFC822.SIZE、自身的时间和BODYSTRUCTURE的信息。
BODYSTRUCTUR：
是邮件的[MIME-IMB]的体结构。
这是服务器通过解析[RFC-2822]头中的[MIME-IMB]各字段和[MIME-IMB]头信息得出来的。
包括的内容有：
邮件正文的类型、字符集、编码方式等和各附件的类型、字符集、编码方式、文件名称等等。
ENVELOPE：
信息的信封结构。
是服务器通过解析[RFC-2822]头中的[MIME-IMB]各字段得出来的，默认各字段都是需要的。
主要包括：
自身的时间、附件数、收件人、发件人等。
FLAGS：
此邮件的标志。
INTERNALDATE：
自身的时间。
RFC822.SIZE：
邮件的[RFC-2822]大小
RFC822.HEADER：
在功能上等同于BODY.PEEK[HEADER]，
RFC822：
功能上等同于BODY[]。
RFC822.TEXT：
功能上等同于BODY[TEXT]
UID：
返回邮件的UID号，UID号是唯一标识邮件的一个号码。
BODY[section]<
partial>
>
：
返回邮件的中的某一指定部分，返回的部分用section来表示，section部分包含的信息通常是代表某一部分的一个数字或者是下面的某一个部分：
HEADER,HEADER.FIELDS,HEADER.FIELDS.NOT,MIME,andTEXT。
如果section部分是空的话，那就代表返回全部的信息，包括头信息。
BODY[HEADER]返回完整的文件头信息。
BODY[HEADER.FIELDS（）]：
在小括号里面可以指定返回的特定字段。
BODY[HEADER.FIELDS.NOT（）]：
在小括号里面可以指定不需要返回的特定字段。
BODY[MIME]：
返回邮件的[MIME-IMB]的头信息，在正常情况下跟BODY[HEADER]没有区别。
BODY[TEXT]：
返回整个邮件体，这里的邮件体并不包括邮件头。
现在我们遇到了一个问题，如果我们要单独提取邮件的附件怎么办？
通过以上的命令我们是无法做到的，但是我们别忘了在section部分还有其他的方式可以来表示我们要提取的邮件的部分，那就的通过区段数来表示。
那下面就让我们来看看什么是区段数。
每个邮件都至少有一个区段数，Non-[MIME-IMB]型的邮件和non-multipart[MIME-IMB]的邮件是没有经过MIME编码之后的信息的，那这样的信息只有一个区段数1。
多区段型的信息被编排成一个连续的区段数，这和实际信息里出现的是一样的。
如果一个特定的区段有类型信息或者是多区段的，一个MESSAGE/RFC822类型的区段也含有嵌套的区段数，这些区段数是指向这些信息区段的信息体的。
说了那么多拗口的，现在我们讲的更简单易懂一些。
在一个邮件体里面，区段数1代表的邮件的正文，区段数二代表的是第一个附件，区段数三代表的是第二个附件，以此类推。
在这些区段里，如果有哪个区段又是多区段的，比如2区段的内容格式是mulipart或者是MESSAGE/RFC822类型的，那么这个区段又嵌套了多个子区段，嵌套的各子区段是用2.1，2.2……等等表示，类似，如果2.1又有嵌套，那么还会有2.1.1，2.1.2等区段。
这样的嵌套是没有限制的。
下面我们通过例子来了解一下fetch具体是怎么按区段下载的。
HEADER（[RFC-2822]headerofthemessage）
TEXT（[RFC-2822]textbodyofthemessage）MULTIPART/MIXED
1TEXT/PLAIN
2APPLICATION/OCTET-STREAM
3MESSAGE/RFC822
3.HEADER（[RFC-2822]headerofthemessage）
3.TEXT（[RFC-2822]textbodyofthemessage）MULTIPART/MIXED
3.1TEXT/PLAIN
3.2APPLICATION/OCTET-STREAM
4MULTIPART/MIXED
4.1IMAGE/GIF
4.1.MIME（[MIME-IMB]headerfortheIMAGE/GIF）
4.2MESSAGE/RFC822
4.2.HEADER（[RFC-2822]headerofthemessage）
4.2.TEXT（[RFC-2822]textbodyofthemessage）MULTIPART/MIXED
4.2.1TEXT/PLAIN
4.2.2MULTIPART/ALTERNATIVE
4.2.2.1TEXT/PLAIN
4.2.2.2TEXT/RICHTEXT
如果我们需要取第一个附件，那么命令就是：
a2fetch4body[2];
取第三个区段的第一个子区段文本正文，命令就是：
a2fetch4body[3.1];
取第四个区段的第二个子区段再嵌套的第一个子区段的文本正文，命令如下：
a2fetch4body[4.2.1]
当然这个例子只是针对于一个特殊的邮件结构，一般的邮件应该都没有这么复杂的结构。
再接下来我们再看看最后一个参数有什么用？
BODY[section]可以使用partial字段进行修改，该字段包含两个用“.”隔开的数字，第一个数字、是八进制表示的希望显示的数据输出起始位置，第二个数字是八进制表示希望显示的数据长度。
这项功能可以进一步设定输出格式，例如，如果你希望显示1号邮件中邮件提的前1500个字符，可以使用命令：
FETCH1BODY[TEXT]<
0.1500>
该命令取回邮件提的前1500个字符并定义为TEXT，如果邮件体少于1500个字符则返回整个邮件体。
例：
100FETCH3：
5BODY[header.fields（DateFromSubject）]/*冒号表示间隔的一个范围：
请求邮件从3到5之间所有邮件的Date：
字段、From：
字段和Subject：
字段的信息*/
*3FETCH（BODY[HEADER.FIELDS（“DATE”“FROM”“SUBJECT”）]{112}
DATE:
Tue,14Sep199910:
09:
50-500
From:
**********************.org
Subject:
Thisisthefirsttestmessage
）
*4FETCH（BODY[HEADER.FIELDS（“DATE”“FROM”“SUBJECT”）]{113}
10:
04-500
Thisisthesecondtestmessage
*5FETCH（BODY[HEADER.FIELDS（“DATE”“FROM”“SUBJECT”）]{112}
20:
26-500
A100OKFETCHcompleted
A101FETCHBODY[TEXT]
*ThisisthefourthtestmessageforIMAP
A101OKFETCHcompleted
FETCH命令是IMAP协议里最复杂的命令。
FETCH的命令参数很多、很复杂，但基本的特征是允许将邮件按照MIME结构拆解为零碎的部件来提取。
例如，可以利用FETCH命令提取邮件头、某一个附件、或某一邮件附件头部的某一字段，等等。
BODY.PEEK[<
section>
]<
在缺省设置时，宏BODY[<
]<
会设置邮件的\SEEN标志。
如果你想在不设置\SEEN标志的情况下阅读邮件的部分信息，那么可以将该宏替代BODY.PEEK[section]，后者完成同前者一样的功能但不会设置该邮件的\SEEN标志。
8．
STORE<
newattributes>
STORE命令用于修改指定邮件的属性，包括给邮件打上已读标记、删除标记，等等。
STORE命令当前只有两个数据项类型可用，FLAGS：
表示邮件的一组标志；
FLAGS.SLIENT，表示一组邮件的标志，通过在两种数据项前加上加号或者减号可以进一步改变它们的执行情况，加号表示数据项的值添加到邮件中，减号表示将数据项的值从邮件中删除。
A003STORE2:
4+FLAGS（\Deleted）/*冒号表示间隔的一个范围：
给从2到4的邮件设置Deleted属性*/
*2FETCHFLAGS（\Deleted\Seen）
*3FETCHFLAGS（\Deleted）
*4FETCHFLAGS（\Deleted\Flagged\Seen）
A003OKSTOREcompleted
9．
CLOSE
CLOSE命令表示Client结束对当前Folder（文件夹/邮箱）的访问，关闭邮箱该邮箱中所有标志为、DELETED的邮件就被从物理上删除。
CLOSE没有命令参数。
随后可以SELECT另一Folder。
A341CLOSE
A341OKCLOSEcompleted
10．
EXPUNGE
EXPUNGE命令在不关闭邮箱的情况下删除所有的标志为、DELETED的邮件。
EXPUNGE删除的邮件将不可以恢复。
A202EXPUNGE
*3EXPUNGE
*5EXPUNGE
*8EXPUNGE
A202OKEXPUNGEcompleted
LOGOUT
LOGOUT命令结束本次IMAP会话。
A023LOGOUT
*BYEIMAP4rev1Serverloggingout
A023OKLOGOUTcompleted
（Serverandclientthenclosetheconnection）
11.
EXAMINE<
mailbox>
EXAMINE命令以只读方式打开邮箱，参数是需要打开的邮箱的名字，使用EXAMINE命令打开的邮箱不允许对邮件进行改动，因此不能增加或删除邮件的标志。
12.
SUBSCRIBE<
SUBSCRIBE命令用来在客户机的活动邮箱列表中增加一个邮箱，该命令只有一个参数，希望添加的邮箱名。
A114SUBSCRIBEnew/anotherbox
A114OKSUBSCRIBEcompleted
13.
UNSUBSCRIBE<
UNSUBSCRIBE命令用来从活动列表中去掉一个邮箱，一个参数：
希望去掉的邮箱名。
A115UNSUBSCRIBEnew/anotherbox
A115OKSUBSCRIBEcompleted
14.
LSUB<
LSUB命令修正了LIST命令，LIST返回用户$HOME目录下所有的文件，但LSUB命令只显示那些使用SUBSCRIBE命令设置为活动邮箱的文件。
两个参数：
邮箱路径和邮箱名。
A116LSUB“”*
*LSUB（）“/”stuff/junk
*LSUB（）“/”neebox
*LSUB（）“/”new/anotherbox
A116OKLSUBcompleted
15.
STATUS<
（<
parameter1>
parameter2>
……<
parameter5>
STATUS命令查询邮箱的当前状态。
第一个参数是需要查询的邮箱名，第二个参数是客户机需要查询的项目列表（要查询显示的信息），当在圆括号中。
STATUS可以在不使用SELECT命令（打开邮箱）或者EXAMINE（以只读方式打开邮箱）前提下获取邮箱的信息。
STATUS命令可以获得的数据项
项目说明
MESSAGE邮箱中的邮件总数
RECENT邮箱中标志为\RECENT的邮件数
UIDNEXT可以分配给新邮件的下一个UID
UIDVALIDITY邮箱的UID有效性标志
UNSEEN邮箱中没有被标志为\UNSEEN的邮件数
A117STATUSinbox（messagerecentunseen）
*STATUSinbox（MESSAGE1RECENT0UNSENN0）
A117OKSTATUScompleted
A118STATUSnewbox（messagerecentunseen）
*STATUSinbox（MESSAGE1RECENT0UNSENN2）
A118OKSTATUScompleted
16.
CHECK
CHECK命令用来在邮箱设置一个检查点。
没有参数。
就是IMAP中的sync命令。
任何未完成的操作，例如从服务器内存向硬盘写数据，都将会被做完以保持邮箱的一致性状态。
该命令确保乃村中的磁盘缓冲数据都被写到了磁盘上。
17．
SEARCH[CHARSETspecification]（searchcriteria）
命令可以根据搜索条件在处于活动状态的邮箱中搜索邮件，然后显示匹配的邮件编号。
字符集标志参数[CHARSETspecification]由CHARSET和注册的字符集标志符组成，缺省的标志符是US-ASCⅡ，所以该参数长省略。
searchcriteria：
查询条件参数，明确查询的关键字和值。
查询关键字有几十种。
A119SEARCHheadersubjectanother
SEARCH12
*A119OKSEARCHcompleted
A120SEARCHheadersubjectanother
*SEARCH2
A120OKSEARCHcompleted
A121SEARCHUNSEEN
*SEARCH12
以上每个例子都在邮件头的Subject:
字段中查询一个不同的单词。
服务器返回条件的邮件号列表，如果没有匹配邮件则返回不带UID的SEARCH单词。
18.
COPY<
mailboxname>
COPY命令可以把邮件从一个邮箱复制到另一个邮箱，两个参数：
mailid是希望从活动邮箱中复制的邮件的标号，mailboxname是希望邮件被复制到的邮箱。
IAMP没有定义移动邮件的命令，移动操作相当于先把邮件复制到新邮箱中，然后对源邮箱中的邮件设置\DELETED标志。
下一次执行检查点过后，新邮箱中的邮件被删除，新邮件就被显示出来。
19.
UID
UID命令和FETCH、COPY、STORE命令或者SEARCH命令一起使用，它允许这些命令使用邮件的UID号而不是在邮箱中的顺序号。
UID号是唯一标识邮件系统中邮件的32位证书。
通常这些命令都使用顺序号来标识邮箱中的邮件，使用UID可以使IMAP客户机记住不同IMAP会话中的邮件。
20.
CAPABILITY
CAPABILITY命令请求返回IMAP服务器支持的功能列表，服务器收到客户机发送的CAPABILITY命令后将返回该服务器所支持的功能。
无参数。
A122CAPABILITY
*A122CAPABILITYIMAP4IMAP4REVlNAMESPACEIDLESCANSORTMAILBOX
--RE
升级会员 