常用IMAP命令Word格式文档下载.docx

1、 A683 OK RENAME completed A684 RENAME stuff/junk newbox /*把stuff目录（文件夹）下的邮箱junk改名为newbox*/ A684 OK RENAME Completed4 LIST templateLIST命令用于列出邮箱中已有的文件夹，有点像操作系统的列目录命令，有两个参数，邮箱路径参数BASE：表示用户登陆目录；第二个参数template：表示希望显示的邮箱名。这个命令可以包含起始的路径位置和需要列出的文件夹所符合的特征，可以使用通配符*。 A101 LIST * LIST （Noselect） / A101 OK LIST C

2、ompleted A102 LIST #p.mail.misc . #news. A102 OK LIST Completed A103 LIST /usr/staff/jones / A103 OK LIST Completed A202 LIST /Mail/ % /Mail/foo * LIST （） /Mail/meetings A202 OK LIST completed5 APPEND date/timesizemail dataAPPEND命令允许Client上载一个邮件到指定的Folder（文件夹/邮箱）中。命令中包含了新邮件的属性、日期/时间、大小，随后是邮件数据。 A003

3、 APPEND saved-messages （Seen） 310 Date: Mon， 7 Feb 1994 21:52:25 -0800 （PST） From: Fred Foobar Subject: afternoon meeting To: *.edu Message-Id:* MIME-Version: 1.0 Content-Type: TEXT/PLAIN; CHARSET=US-ASCII Hello Joe， do you think we can meet at 3:30 tomorrow? A003 OK APPEND completed6 SELECT SELECT命

4、令让Client选定某个邮箱（Folder），表示即将对该邮箱（Folder）内的邮件作操作。邮箱标志的当前状态也返回给了用户，同时返回的还有一些关于邮件和邮箱的附加信息。 A142 SELECT INBOX * 172 EXISTS * 1 RECENT * OK UNSEEN 12 Message 12 is first unseen * OK UIDVALIDITY 3857529045 UIDs valid * FLAGS （Answered Flagged Deleted Seen Draft） * OK PERMANENTFLAGS （Deleted Seen *） Limited

5、 A142 OK READ-WRITE SELECT completed7 FETCH datanames FETCH 命令用于读取邮件的文本信息，且仅用于显示的目的。包含两个参数，messageset：表示希望读取的邮件号列表，IAMP服务器邮箱中的每个邮件都有一个唯一的ID标识，（邮件号列表参数可以是一个邮件号，也可以是由逗号分隔的多个邮件号，或者由冒号间隔的一个范围），IMAP服务器返回邮件号列表中全部邮件的指定数据项内容。数据名参数确定能够被独立返回的邮件的一部分，下面我们看看各参数返回的邮件信息：ALL：只返回按照一定格式的邮件摘要，包括邮件标志、RFC822.SIZE、自身的时间和

6、信封信息。IMAP客户机能够将标准邮件解析成这些信息并显示出来。BODY：只返回邮件体文本格式和大小的摘要信息。IMAP客户机可以识别这些细腻，并向用户显示详细的关于邮件的信息。其实是一些非扩展的BODYSTRUCTURE的信息。FAST：只返回邮件的一些摘要，包括邮件标志、RFC822.SIZE、和自身的时间。FULL：同样的还是一些摘要信息，包括邮件标志、RFC822.SIZE、自身的时间和BODYSTRUCTURE的信息。BODYSTRUCTUR：是邮件的MIME-IMB的体结构。这是服务器通过解析RFC-2822头中的MIME-IMB各字段和MIME-IMB头信息得出来的。包括的内容有

7、：邮件正文的类型、字符集、编码方式等和各附件的类型、字符集、编码方式、文件名称等等。ENVELOPE：信息的信封结构。是服务器通过解析RFC-2822头中的MIME-IMB各字段得出来的，默认各字段都是需要的。主要包括：自身的时间、附件数、收件人、发件人等。FLAGS：此邮件的标志。INTERNALDATE：自身的时间。RFC822.SIZE：邮件的RFC-2822大小RFC822.HEADER：在功能上等同于BODY.PEEKHEADER，RFC822：功能上等同于BODY。RFC822.TEXT：功能上等同于BODYTEXTUID：返回邮件的UID号，UID号是唯一标识邮件的一个号码。BO

8、DYsection ：返回邮件的中的某一指定部分，返回的部分用section来表示，section部分包含的信息通常是代表某一部分的一个数字或者是下面的某一个部分：HEADER, HEADER.FIELDS, HEADER.FIELDS.NOT, MIME, and TEXT。如果section部分是空的话，那就代表返回全部的信息，包括头信息。BODYHEADER返回完整的文件头信息。BODYHEADER.FIELDS （）：在小括号里面可以指定返回的特定字段。BODYHEADER.FIELDS.NOT （）：在小括号里面可以指定不需要返回的特定字段。BODYMIME：返回邮件的MIME-IM

9、B的头信息，在正常情况下跟BODYHEADER没有区别。BODYTEXT：返回整个邮件体，这里的邮件体并不包括邮件头。现在我们遇到了一个问题，如果我们要单独提取邮件的附件怎么办？通过以上的命令我们是无法做到的，但是我们别忘了在section部分还有其他的方式可以来表示我们要提取的邮件的部分，那就的通过区段数来表示。那下面就让我们来看看什么是区段数。每个邮件都至少有一个区段数，Non-MIME-IMB型的邮件和non-multipart MIME-IMB的邮件是没有经过MIME编码之后的信息的，那这样的信息只有一个区段数1。多区段型的信息被编排成一个连续的区段数，这和实际信息里出现的是一样的。如

10、果一个特定的区段有类型信息或者是多区段的，一个MESSAGE/RFC822类型的区段也含有嵌套的区段数，这些区段数是指向这些信息区段的信息体的。说了那么多拗口的，现在我们讲的更简单易懂一些。在一个邮件体里面，区段数1代表的邮件的正文，区段数二代表的是第一个附件，区段数三代表的是第二个附件，以此类推。在这些区段里，如果有哪个区段又是多区段的，比如2区段的内容格式是mulipart或者是 MESSAGE/RFC822类型的，那么这个区段又嵌套了多个子区段，嵌套的各子区段是用2.1，2.2等等表示，类似，如果2.1又有嵌套，那么还会有2.1.1，2.1.2等区段。这样的嵌套是没有限制的。下面我们通过

11、例子来了解一下fetch具体是怎么按区段下载的。HEADER （RFC-2822 header of the message）TEXT （RFC-2822 text body of the message） MULTIPART/MIXED1 TEXT/PLAIN2 APPLICATION/OCTET-STREAM3 MESSAGE/RFC8223.HEADER （RFC-2822 header of the message）3. TEXT （RFC-2822 text body of the message） MULTIPART/MIXED3.1 TEXT/PLAIN3.2 APPLICATI

12、ON/OCTET-STREAM4 MULTIPART/MIXED4.1 IMAGE/GIF4.1. MIME （MIME-IMB header for the IMAGE/GIF）4.2 MESSAGE/RFC8224.2. HEADER （RFC-2822 header of the message）4.2. TEXT （RFC-2822 text body of the message） MULTIPART/MIXED4.2.1 TEXT/PLAIN4.2.2 MULTIPART/ALTERNATIVE4.2.2.1 TEXT/PLAIN4.2.2.2 TEXT/RICHTEXT如果我们需

13、要取第一个附件，那么命令就是：a2 fetch 4 body2;取第三个区段的第一个子区段文本正文，命令就是：a2 fetch 4 body3.1;取第四个区段的第二个子区段再嵌套的第一个子区段的文本正文，命令如下：a2 fetch 4 body4.2.1当然这个例子只是针对于一个特殊的邮件结构，一般的邮件应该都没有这么复杂的结构。再接下来我们再看看最后一个参数有什么用？BODYsection可以使用partial字段进行修改，该字段包含两个用“.”隔开的数字，第一个数字、是八进制表示的希望显示的数据输出起始位置，第二个数字是八进制表示希望显示的数据长度。这项功能可以进一步设定输出格式，例如，

14、如果你希望显示1号邮件中邮件提的前1500个字符，可以使用命令：FETCH 1 BODYTEXT该命令取回邮件提的前1500个字符并定义为TEXT，如果邮件体少于1500个字符则返回整个邮件体。例： 100 FETCH 3：5 BODYheader.fields （Date From Subject） /*冒号表示间隔的一个范围：请求邮件从3到5之间所有邮件的Date：字段、 From：字段和 Subject：字段的信息*/ * 3 FETCH （BODYHEADER.FIELDS （“DATE” “FROM” “SUBJECT”） 112DATE: Tue, 14 Sep 1999 10:0

15、9:50 -500From: *.orgSubject: This is the first test message） * 4 FETCH （BODYHEADER.FIELDS （“DATE” “FROM” “SUBJECT”） 11310:04 -500 This is the second test message * 5 FETCH （BODYHEADER.FIELDS （“DATE” “FROM” “SUBJECT”） 11220:26 -500 A100 OK FETCH completed A101 FETCH BODYTEXT* This is the fourth test

16、message for IMAP A101 OK FETCH completedFETCH命令是IMAP协议里最复杂的命令。FETCH的命令参数很多、很复杂，但基本的特征是允许将邮件按照MIME结构拆解为零碎的部件来提取。例如，可以利用FETCH命令提取邮件头、某一个附件、或某一邮件附件头部的某一字段，等等。BODY.PEEK 在缺省设置时，宏BODY会设置邮件的SEEN标志。如果你想在不设置SEEN标志的情况下阅读邮件的部分信息，那么可以将该宏替代BODY .PEEKsection，后者完成同前者一样的功能但不会设置该邮件的SEEN标志。8 STORE STORE 命令用于修改指定邮件的属性

17、，包括给邮件打上已读标记、删除标记，等等。STORE命令当前只有两个数据项类型可用，FLAGS：表示邮件的一组标志；FLAGS.SLIENT，表示一组邮件的标志，通过在两种数据项前加上加号或者减号可以进一步改变它们的执行情况，加号表示数据项的值添加到邮件中，减号表示将数据项的值从邮件中删除。 A003 STORE 2:4 +FLAGS （Deleted） /*冒号表示间隔的一个范围：给从2到4的邮件设置Deleted属性*/ * 2 FETCH FLAGS （Deleted Seen） * 3 FETCH FLAGS （Deleted） * 4 FETCH FLAGS （Deleted Fla

18、gged Seen） A003 OK STORE completed9 CLOSECLOSE命令表示Client结束对当前Folder（文件夹/邮箱）的访问，关闭邮箱该邮箱中所有标志为、DELETED的邮件就被从物理上删除。CLOSE没有命令参数。随后可以SELECT另一Folder。 A341 CLOSE A341 OK CLOSE completed10 EXPUNGEEXPUNGE命令在不关闭邮箱的情况下删除所有的标志为、DELETED的邮件。EXPUNGE删除的邮件将不可以恢复。 A202 EXPUNGE * 3 EXPUNGE * 5 EXPUNGE * 8 EXPUNGE A202

19、 OK EXPUNGE completed LOGOUTLOGOUT命令结束本次IMAP会话。 A023 LOGOUT * BYE IMAP4rev1 Server logging out A023 OK LOGOUT completed（Server and client then close the connection）11. EXAMINE EXAMINE命令以只读方式打开邮箱，参数是需要打开的邮箱的名字，使用EXAMINE命令打开的邮箱不允许对邮件进行改动，因此不能增加或删除邮件的标志。12.SUBSCRIBE SUBSCRIBE命令用来在客户机的活动邮箱列表中增加一个邮箱，该命令只

20、有一个参数，希望添加的邮箱名。 A114 SUBSCRIBE new/anotherbox A114 OK SUBSCRIBE completed13.UNSUBSCRIBE UNSUBSCRIBE命令用来从活动列表中去掉一个邮箱，一个参数：希望去掉的邮箱名。 A115 UNSUBSCRIBE new/anotherbox A115 OK SUBSCRIBE completed14. LSUB LSUB命令修正了LIST命令，LIST返回用户$HOME目录下所有的文件，但LSUB命令只显示那些使用SUBSCRIBE命令设置为活动邮箱的文件。两个参数：邮箱路径和邮箱名。 A116 LSUB “”

21、 * LSUB （） “/” stuff/junk* LSUB （） “/” neebox* LSUB （） “/” new/anotherbox A116 OK LSUB completed15. STATUS （ parameter2 STATUS命令查询邮箱的当前状态。第一个参数是需要查询的邮箱名，第二个参数是客户机需要查询的项目列表（要查询显示的信息），当在圆括号中。STATUS可以在不使用SELECT命令（打开邮箱）或者EXAMINE（以只读方式打开邮箱）前提下获取邮箱的信息。 STATUS命令可以获得的数据项 项 目 说 明MESSAGE 邮箱中的邮件总数RECENT 邮箱中标志为

22、RECENT的邮件数UIDNEXT 可以分配给新邮件的下一个UIDUIDVALIDITY 邮箱的UID有效性标志UNSEEN 邮箱中没有被标志为UNSEEN的邮件数 A117 STATUS inbox （message recent unseen）* STATUS inbox （MESSAGE 1 RECENT 0 UNSENN 0） A117 OK STATUS completed A118 STATUS newbox （message recent unseen）* STATUS inbox （MESSAGE 1 RECENT 0 UNSENN 2） A118 OK STATUS comp

23、leted16. CHECK CHECK命令用来在邮箱设置一个检查点。没有参数。就是IMAP中的sync命令。任何未完成的操作，例如从服务器内存向硬盘写数据，都将会被做完以保持邮箱的一致性状态。该命令确保乃村中的磁盘缓冲数据都被写到了磁盘上。17 SEARCH CHARSET specification （search criteria）命令可以根据搜索条件在处于活动状态的邮箱中搜索邮件，然后显示匹配的邮件编号。字符集标志参数CHARSET specification由CHARSET和注册的字符集标志符组成，缺省的标志符是US-ASC，所以该参数长省略。search criteria：查询条件

24、参数，明确查询的关键字和值。查询关键字有几十种。 A119 SEARCH header subject another SEARCH 1 2* A119 OK SEARCH completed A120 SEARCH header subject another *SEARCH 2 A120 OK SEARCH completed A121 SEARCH UNSEEN *SEARCH 1 2以上每个例子都在邮件头的Subject:字段中查询一个不同的单词。服务器返回条件的邮件号列表，如果没有匹配邮件则返回不带UID的SEARCH单词。18. COPY COPY命令可以把邮件从一个邮箱复制到另一

25、个邮箱，两个参数：mail id是希望从活动邮箱中复制的邮件的标号，mailboxname是希望邮件被复制到的邮箱。IAMP没有定义移动邮件的命令，移动操作相当于先把邮件复制到新邮箱中，然后对源邮箱中的邮件设置DELETED标志。下一次执行检查点过后，新邮箱中的邮件被删除，新邮件就被显示出来。19. UIDUID 命令和FETCH、COPY、STORE命令或者SEARCH命令一起使用，它允许这些命令使用邮件的UID号而不是在邮箱中的顺序号。UID号是唯一标识邮件系统中邮件的32位证书。通常这些命令都使用顺序号来标识邮箱中的邮件，使用UID可以使IMAP客户机记住不同IMAP会话中的邮件。20. CAPABILITYCAPABILITY命令请求返回IMAP服务器支持的功能列表，服务器收到客户机发送的CAPABILITY命令后将返回该服务器所支持的功能。无参数。 A122 CAPABILITY*A122 CAPABILITY IMAP4 IMAP4REVl NAMESPACE IDLE SCAN SORT MAILBOX-RE