Download the PHP package leonardoweslei/eden-mail without Composer
On this page you can find all versions of the php package leonardoweslei/eden-mail. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download leonardoweslei/eden-mail
More information about leonardoweslei/eden-mail
Files in leonardoweslei/eden-mail
Package eden-mail
Short Description Eden POP3, IMAP and SMTP component
License MIT
Homepage http://eden-php.com
Informations about the package eden-mail
Eden Mail
- Install
- Introduction
- IMAP
- POP3
- SMTP
- Contributing
====
Install
composer install eden/mail
====
Introduction
Eden sports the three common ways to interact with mail servers including SMTP, IMAP and POP3. Accessing each protocol can be acheived like in Figure 1
.
Figure 1. Factory
For all three protocols there are four 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.
====
IMAP
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 2
shows how to set up the IMAP object.
Figure 2. Setting up the IMAP Object
Very simply, there are four 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.
Mailboxes
The next thing we want to know are the available mailboxes we can set to active. To get a list of mailboxes follow Figure 3
.
Figure 3. Mailbox List
Executing the above command will give you the following results.
Every mail server we looked at has the INBOX folder. So when in doubt, we would say this should be the default active mailbox. Next let's set the INBOX as the active mailbox. Figure 4
shows how we would set and retrieve the active mailbox in one line.
Figure 4. Set Active Mailbox FIRST!
Emails
Now that we have set the active mailbox, we can now continue to get a list of emails. Figure 5
shows how we would go about doing that.
Figure 5. Getting a List of Emails
Executing the above figure would yield you results similar to the snippet below.
Figure 5a. Example Email Results
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 6
shows how we would get the details of an email.
Figure 6. Get the Complete Email Details
In the figure above, we call getUniqueEmails()
the first argument should be the unique identifier (UID) found in Figure 5a
. 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 6a. Get More Than One Email Detail
Including the body and attachments in a list request would definitely take a long time and is not recommended.
Searching
Searching emails follows the basic IMAP format for searching. An example of how to search can be found in Figure 7
.
Figure 7. Searching
Search is confined to the emails in the active mailbox. This is an IMAP standard. There is no work around for this.
The combinations of search queries can be referenced below:
ALL - return all messages matching the rest of the criteria
ANSWERED - match messages with the \\ANSWERED flag set
BCC "string" - match messages with "string" in the Bcc: field
BEFORE "date" - match messages with Date: before "date"
BODY "string" - match messages with "string" in the body of the message
CC "string" - match messages with "string" in the Cc: field
DELETED - match deleted messages
FLAGGED - match messages with the \\FLAGGED (sometimes referred to as Important or Urgent) flag set
FROM "string" - match messages with "string" in the From: field
KEYWORD "string" - match messages with "string" as a keyword
NEW - match new messages
OLD - match old messages
ON "date" - match messages with Date: matching "date"
RECENT - match messages with the \\RECENT flag set
SEEN - match messages that have been read (the \\SEEN flag is set)
SINCE "date" - match messages with Date: after "date"
SUBJECT "string" - match messages with "string" in the Subject:
TEXT "string" - match messages with text "string"
TO "string" - match messages with "string" in the To:
UNANSWERED - match messages that have not been answered
UNDELETED - match messages that are not deleted
UNFLAGGED - match messages that are not flagged
UNKEYWORD "string" - match messages that do not have the keyword "string"
UNSEEN - match messages which have not been read yet
Actions
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 8. Move Email to Another Folder
Figure 9. Delete Email
Figure 10. Don't Forget to Disconnect!
====
POP3
Eden's POP3 object does uses fsocket()
rather than PHP's built in IMAP functions for POP3. We chose to use fsocket()
instead purely because of performance reasons. You'll find setting up POP3 is overall easier with Eden. Figure 11
shows how to set up the POP3 object.
Figure 11. Setting up the POP3 Object
Very simply, there are four 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.Now that we have set the connection information, we can now continue to get a list of emails. Figure 12
shows how we would go about doing that.
Figure 12. Get Emails
Executing the above figure would return you a list of emails as well as the total count. Some other actions you would probably like to perform is removing an email. The following figures shows basically the rest of the possible actions you can perform with Eden.
Figure 13. Delete Email
Figure 14. Don't Forget to Disconnect!
====
SMTP
SMTP in Eden is relatively easier. We use fsocket()
rather than PHP's built in SMTP functions. We chose to use fsocket()
because PHP's mail()
function will most likely put your mail in the junk folder. SMTP works better because emails sent is sent by your actual email server versus your web host. Figure 15
shows how to set up the SMTP object.
Figure 15. Setting up the SMTP Object
Very simply, there are four 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 part is simply send your email.
Figure 16. Simply Send
In Figure 16
, we basically laid out all the possible combinations of methods you can use to send email. It's important to set the addTo()
method at least once.
Figure 17. Don't Forget to Disconnect!
====
Contributing to Eden
Contributions to Eden are following the Github work flow. Please read up before contributing.
Setting up your machine with the Eden repository and your fork
- Fork the repository
- Fire up your local terminal create a new branch from the
v4
branch of your fork with a branch name describing what your changes are. Possible branch name types:- bugfix
- feature
- improvement
- Make your changes. Always make sure to sign-off (-s) on all commits made (git commit -s -m "Commit message")
Making pull requests
- Please ensure to run
phpunit
before making a pull request. - Push your code to your remote forked version.
- Go back to your forked version on GitHub and submit a pull request.
- An Eden developer will review your code and merge it in when it has been classified as suitable.
All versions of eden-mail with dependencies
eden/core Version 4.0.3.1
eden/string Version 4.*
eden/array Version 4.*
eden/path Version 4.*
eden/file Version 4.*