gaswelder/smtp

SMTP client

0.9.0 2017-09-01 21:19 UTC

MIT

README

This client speaks SMTP protocol to deliver messages. This makes it possible to:

• send mail from where normal mail functions are not working;
• send the message to many recipients in one call.

Basic usage example

use gaswelder\smtp\Client;
use gaswelder\smtp\Mail;

$mail = new Mail();
$mail->subject = "Hey there";
$mail->body = ";)";

$returnPath = "[e-mail]";
$destinationPath = "[e-mail]";

$smtp = new Client();
$smtp->connect("smtp.example.net");
$smtp->login("bob", "****");
$smtp->send($mail, $returnPath, $destinationPath);

Mail list example

use gaswelder\smtp\Client;
use gaswelder\smtp\Mail;

$mail = new Mail();
$mail->to = "To whom it might concern";
$mail->subject = "Viagra!";
$mail->body = ";)";

$recipients = [
	"[e-mail]",
	"[e-mail]",
	"[e-mail]"
];
$smtp = new Client();
$smtp->connect("mail.net");
$smtp->login("mailer", "****");
$smtp->send($mail, "[e-mail]", $recipients);

SSL

The client always uses SSL (STARTTLS) before logging in. It's possible to tweak the SSL parameters by defining the ssl option to a map of SSL context options according to http://php.net/manual/en/context.ssl.php. For example, to allow self-signed certificates:

$client = new Client([
	'ssl' => [
		'allow_self_signed' => true
	]
]);

Logging

To get log messages (which include client and server messages sent over the connection) define the logger option to be a callable accepting the log line:

$client = new Client([
	'logger' => function($line) {
		fwrite(STDERR, $line."\n");
	}
]);

Installation

composer require gaswelder/smtp