jacobemerick/archangel

Another PHP mailing script, this time with method chaining

2.1.0 2016-02-07 22:13 UTC

This package is not auto-updated.

Last update: 2024-10-26 18:54:44 UTC


README

Build Status Code Climate Test Coverage Scrutinizer Code Quality

Encapsulated utility for sending out emails with PHP. Will separate out plain-text, html, and attachments. Works across several tested email clients, including the picky Microsoft Outlook.

Why Archangel? Well, it's cool (like bow ties) and technically an 'archangel' is a 'messenger'.

Installation

It's recommended that you use Composer to install Archangel.

$ composer require jacobemerick/archangel "^2.0"

This will install Archangel and it's dependencies. It requires PHP 5.3.0 or newer and sendmail functionality.

Usage

There are some minimum values to set before Archangel will attempt to send a mail. They are:

  • to address
  • subject
  • some type of message (plain text, html, or attachment(s))

Archangel can work with or without method chaining. In the below examples everything is chained, but you don't have to structure your calling this way - it is totally up to you.

Basic structure

Basic structure of a chained vs unchained request.

(new Jacobemerick\Archangel\Archangel())
  ->addTo('email@example.com')
  ->setSubject('Test Subject')
  ->setPlainMessage('This is a rather plain message.')
  ->send();

$archangel = new Jacobemerick\Archangel\Archangel();
$archangel->addTo('email@example.com');
$archangel->setSubject('Test Subject');
$archangel->setPlainMessage('This is a rather plain message.');
$archangel->send();

Future Todos

  • add in more documentation

License

Archangel is licensed under the MIT license. See License File for more information.