Download the PHP package hoa/mail without Composer
On this page you can find all versions of the php package hoa/mail. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package mail
Hoa is a modular, extensible and
structured set of PHP libraries.
Moreover, Hoa aims at being a bridge between industrial and research worlds.
Hoa\Mail
This library allows to compose and send rich emails (textual contents, HTML
documents, alternative contents, attachments etc., this is very extensible).
Email can be sent with sendmail or SMTP. The SMTP layer supports TLS and
PLAIN, LOGIN and CRAM-MD5 authentications.
In a near future, this library will also allow to receive and parse emails.
Installation
With Composer, to include this library into
your dependencies, you need to
require hoa/mail:
For more installation procedures, please read the Source page.
Testing
Before running the mail suites, the development dependencies must be installed:
Then, to run all the test suites:
For more information, please read the contributor guide.
Quick usage
We propose a quick overview to send a very simple email with only one content, and then, a more complex email with an alternative content and an attachment.
Simple email
Before all, just like any messaging softwares, we have to setup the transport. We will send our email by using SMTP as the default transport. We will specify a socket to the SMTP server, a login and a password:
Then, we will get an instance of a message and set all the headers, such as
From, To and Subject, we will add a textual content and we will send it:
Notice that we can use any view or template library to produce the content of the mail!
Rich email
Now, instead of having only one textual content, we will have an alternative content: either textual or HTML.
Then, to add an attachment, we will add a new kind of content. The attachment is
an image that will be named Foobar.jpg. Thus:
And finally, we send the email:
Complex email
Now imagine we do not want the image to be only attached but appear in the HTML content. These contents are related. Here is how to construct the email (with more variables to clarify):
Documentation
The
hack book of Hoa\Mail contains
detailed information about how to use this library and how it works.
To generate the documentation locally, execute the following commands:
More documentation can be found on the project's website: hoa-project.net.
Getting help
There are mainly two ways to get help:
- On the
#hoaprojectIRC channel, - On the forum at users.hoa-project.net.
Contribution
Do you want to contribute? Thanks! A detailed contributor guide explains everything you need to know.
License
Hoa is under the New BSD License (BSD-3-Clause). Please, see
LICENSE for details.
All versions of mail with dependencies
hoa/exception Version ~1.0
hoa/mime Version ~3.0
hoa/socket Version ~1.0