Need help with php-simple-mail?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

eoghanobrien
206 Stars 88 Forks MIT License 133 Commits 4 Opened issues

Description

Provides a simple, chainable wrapper for creating and sending emails using the PHP mail() function.

Services available

!
?

Need anything else?

Contributors list

# 85,254
pdf-mer...
curl
hashids
Azure
5 commits
# 66,506
CSS
PHP
node
test-fr...
3 commits
# 599,673
PHP
2 commits
# 333,781
stow
yadm
PHP
HTML
2 commits
# 591,314
PHP
craft-p...
craft3
2 commits
# 572,325
PHP
Python
passwor...
alfred
1 commit
# 514,985
CSS
JavaScr...
Shell
1 commit
# 668,008
PHP
1 commit

README

Build Status Latest Stable Version Scrutinizer Quality Score Code Coverage Total Downloads License PHP 7 ready

Introduction

Simple Mail Class provides a simple, chainable wrapper for creating and sending emails using the PHP

mail()
function. There are better options out there for sending SMTP email, which are more secure and more reliable than the
mail()
function. However, sometimes you just need to send a simple email. That's what we cover.

Installation via Composer

$ composer require eoghanobrien/php-simple-mail

Usage

Instantiating the class.

You have two options, you can 'new up' the class in the traditional way:

$mailer = new SimpleMail();

or instantiate it using the named static constructor

make()
php
$mailer = SimpleMail::make();
The static constructor can be useful when you want to continue chaining methods after instantiating.
php
SimpleMail::make()
->setTo($email, $name)
->setFrom($fromEmail, $fromName)
->setSubject($subject)
->setMessage($message)
->send();

To
header

The

To
header can be called multiple time, in order to pass more than one
To
address, simply call the
setTo
method as many times as needed. It takes two string parameters. The first parameter is for the email address, the second is for the name.
SimpleMail::make()
 ->setTo($email1, $name1)
 ->setTo($email2, $name2);

From
header

You can carbon copy one or more addresses using the

setBcc
method. It takes two string parameters. The first parameter is for the email address, the second is for the name.
SimpleMail::make()
  ->setFrom('[email protected]', 'John Smith');

Cc
header

You can carbon copy one or more addresses using the

setCc
method. It takes an array of
$name => $email
pairs. Alternatively, you can pass a simple numerically keyed array an the value is assumed to be the email.
SimpleMail::make()
  ->setCc(['John Smith', '[email protected]');

Bcc
header

You can blind carbon copy one or more addresses using the

setBcc
method. It takes an array of
$name => $email
pairs. Alternatively, you can pass a simple numerically keyed array an the value is assumed to be the email.
SimpleMail::make()
  ->setBcc(['John Smith', '[email protected]');

Subject
header

You can set the subject using

setSubject
method. It takes a string as the only parameter.
SimpleMail::make()
    ->setSubject("Important information about your account");

Message
header

You can set the message using

setMessage
method. It takes a string as the only parameter.
SimpleMail::make()
    ->setMessage("My important message!");

HTML
emails

If you want to include HTML in your email. Simply call the

setHtml()
method. It takes no parameters.
SimpleMail::make()
    ->setMessage("My important message!")
    ->setHtml();

send
emails

Once you've set all your headers. Use the

send()
method to finally send it on it's way.
SimpleMail::make()
    ->setMessage("My important message!")
    ->send();

Full example of sending an email

$send = SimpleMail::make()
    ->setTo($email, $name)
    ->setFrom($fromEmail, $fromName)
    ->setSubject($subject)
    ->setMessage($message)
    ->setReplyTo($replyEmail, $replyName)
    ->setCc(['Bill Gates' => '[email protected]'])
    ->setBcc(['Steve Jobs' => '[email protected]'])
    ->setHtml()
    ->setWrap(100)
    ->send();

echo ($send) ? 'Email sent successfully' : 'Could not send email';

Example of sending an email with attachments

If you are sending an attachment there is no need to add any addGenericHeader()'s. To properly send the attachments the necessary headers will be set for you. You can also chain as many attachments as you want (see example).

$send = SimpleMail::make()
    ->setTo($email, $name)
    ->setFrom($fromEmail, $fromName)
    ->setSubject($subject)
    ->setMessage($message)
    ->setReplyTo($replyEmail, $replyName)
    ->setCc(['Bill Gates' => '[email protected]'])
    ->setBcc(['Steve Jobs' => '[email protected]'])
    ->setHtml()
    ->setWrap(100)
    ->addAttachment('example/pbXBsZSwgY2hh.jpg', 'lolcat_finally_arrived.jpg')
    ->addAttachment('example/lolcat_what.jpg')
    ->send();

echo ($send) ? 'Email sent successfully' : 'Could not send email';

License

php-simple-mail is free and unencumbered public domain software. For more information, see http://opensource.org/licenses/MIT or the accompanying MIT file.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.