Lucee Tag Reference
Tag <CFIMAP>
Retrieves and deletes e-mail messages from a Imap mail server.
This tag works exactly the same way as the cfmail tag. It has the same attributes.
The Internet Message Access Protocol or IMAP is one of two of the most prevalent Internet standard protocols for e-mail retrieval,
the other being POP3. Virtually all modern e-mail clients and servers support both protocols as a means of transferring e-mail messages from a server,
such as those used by Gmail, to a client, such as Mozilla Thunderbird and Microsoft Outlook.
Many implementations of webmail use IMAP to retrieve e-mail messages from a server and display them within a web browser,
making the use of this protocol transparent to the user.
Body
This tag can't have a body.
Example
<cfimap [action="string"] [attachmentpath="string"] [debug="boolean"] [generateuniquefilenames="boolean"] [maxrows="number"] [messagenumber="string"] [name="string"] [password="string"] [port="number"] server="string" [startrow="number"] [timeout="number"] [uid="string"] [username="string"]>
This tag is also supported within cfscript
<cfscript> imap [action="string"] [attachmentpath="string"] [debug="boolean"] [generateuniquefilenames="boolean"] [maxrows="number"] [messagenumber="string"] [name="string"] [password="string"] [port="number"] server="string" [startrow="number"] [timeout="number"] [uid="string"] [username="string"]; </cfscript>
Attributes
The attributes for this tag are fixed. Except for the following attributes no other attributes are allowed.
Name | Type | Required | Description |
---|---|---|---|
action | string | No | Specifies the mail action. |
attachmentpath | string | No | Allows attachments to be written to the specified directory when action = "getAll". If an invalid attachmentPath is specified, no attachment files are written to the server. |
debug | boolean | No | This Attribute is deprecated |
generateuniquefilenames | boolean | No | Boolean indicating whether to generate unique filenames for the files attached to an e-mail message to avoid naming conflicts when the files are saved. Default is NO. |
maxrows | number | No | Sets the number of messages returned, starting with the number in the startRow attribute. This attribute is ignored if messageNumber is specified. |
messagenumber | string | No | Can be a comma-separated list of the message ids |
name | string | No | Name for the index query. |
password | string | No | Password that corresponds to user name. |
port | number | No | Defaults to the standard Imap port, 143. |
server | string | Yes | Host name biff.upperlip.com or IP address 192.1.2.225 of the Imap server. |
startrow | number | No | Specifies the first row number to be retrieved. Default is 1. This attribute is ignored if messageNumber is specified. |
timeout | number | No | Specifies the maximum time, in seconds, to wait for mail processing. Defaults is 60 seconds. |
uid | string | No | Specifies the unique ID or a comma-delimited list of Uids to retrieve or delete. If you set invalid Uids, then they are ignored. |
username | string | No | If no user name is specified, the Imap connection is anonymous. |