Eden's IMAP object does uses fsocket() rather than PHP's built in IMAP functions. We chose to use fsocket() instead purely because of performance reasons. You'll find setting up IMAP is overall easier with Eden. Figure 1 shows how to set up the IMAP object.Figure 1. Setting up the IMAP Object
$imap = eden('mail')->imap('imap.gmail.com', 'email@example.com', '[YOUR PASSWORD]', 993, true);
Very simply, there are 4 requirements that's needed and all requirements are dependent on your specific email provider. In the figure above we use GMAIL settings as an example. The last argument is a flag. Set it to true if your email provider requires SSL.
The next thing we want to know are the available mailboxes we can set to active. To get a list of mailboxes follow Figure 2.Figure 2. Mailbox List
$mailboxes = $imap->getMailboxes();
Executing the above command will give you the following results.
Array (  => Deleted Messages  => Drafts  => INBOX  => Junk E-mail  => Notes  => Sent Messages  => Trash  => [Gmail]/All Mail  => [Gmail]/Drafts  => [Gmail]/Important  => [Gmail]/Personal  => [Gmail]/Sent Mail  => [Gmail]/Spam  => [Gmail]/Starred  => [Gmail]/System  => [Gmail]/Trash  => [Gmail]/Unsorted )
Next let's set the INBOX as the active mailbox. Figure 3 shows how we would set and retrieve the active mailbox in one line.Figure 3. Set Active Mailbox FIRST!
echo $imap->setMailboxes('INBOX')->getActiveInbox(); //--> INBOX
Now that we have set the active mailbox, we can now continue to get a list of emails. Figure 4 shows how we would go about doing that.Figure 4. Getting a List of Emails
$emails = $imap->getEmails(0, 3); $count = $imap->getEmailTotal();
Executing the above figure would yield you results similar to the snippet below.Figure 4a. Example Email Results
Array (  => Array ( [id] => <firstname.lastname@example.org> [parent] => [topic] => Trending Startups and Updates [mailbox] => INBOX [uid] => 22363 [date] => 1342446257 [subject] => Trending Startups and Updates [from] => Array( [name] => AngelList [email] => email@example.com ) [flags] => Array (  => seen ) [to] => Array (  => Array( [email] => firstname.lastname@example.org ) ) [cc] => Array() [bcc] => Array() ) ... )
As you might realize, the email list does not come with the full body nor the attachments. Standard IMAP practices explain you should not try to get a detailed list, because the mere size of the full data could take a long while.
The idea for when you should retrieve the full details is when a user specifically call to action to see the body. Figure 5 shows how we would get the details of an email.Figure 5. Get the Complete Email Details
$email = $imap->getUniqueEmails(22363, true); echo $email['body']['text/html'];
In the figure above, we call getUniqueEmails() the first argument should. be the unique identifier (UID) found in Figure 4a. The second argument is whether if you want the body, leave this true usually. You could get a group of emails comma separated by UIDs in the following manner.Figure 5a. Get More Than One Email Detail
$emails = $imap->getUniqueEmails(array(22363, 22364), true);
Searching Emails follows the basic IMAP format for searching. An example of how to search can be found in Figure 6.Figure 6. Searching
$emails = $imap->search(array('TO "email@example.com"'), 0, 3);
The combinations of search queries can be referenced below:
Some other actions you would probably like to perform is moving an email and removing an email. The following figures shows basically the rest of the possible actions you can perform with Eden.Figure 7. Move Email to Another Folder
IMAP is used only for retrieving documents. To send emails the best way is with SMTP, which is covered in our next section B. SMTP.« 16. Unit Testing B. SMTP »