first commit

code/web/backend/application/core/Mail.php

@@ -0,0 +1,115 @@
+<?php
+
+class Mail
+{
+	/** @var mixed variable to collect errors */
+	private $error;
+
+	/**
+	 * Try to send a mail by using PHP's native mail() function.
+	 * Please note that not PHP itself will send a mail, it's just a wrapper for Linux's sendmail or other mail tools
+	 *
+	 * Good guideline on how to send mails natively with mail():
+	 * @see http://stackoverflow.com/a/24644450/1114320
+	 * @see http://www.php.net/manual/en/function.mail.php
+	 */
+	public function sendMailWithNativeMailFunction()
+	{
+		// no code yet, so we just return something to make IDEs and code analyzer tools happy
+		return false;
+	}
+
+	/**
+	 * Try to send a mail by using SwiftMailer.
+	 * Make sure you have loaded SwiftMailer via Composer.
+	 *
+	 * @return bool
+	 */
+	public function sendMailWithSwiftMailer()
+	{
+		// no code yet, so we just return something to make IDEs and code analyzer tools happy
+		return false;
+	}
+
+	/**
+	 * Try to send a mail by using PHPMailer.
+	 * Make sure you have loaded PHPMailer via Composer.
+	 * Depending on your EMAIL_USE_SMTP setting this will work via SMTP credentials or via native mail()
+	 *
+	 * @param $user_email
+	 * @param $from_email
+	 * @param $from_name
+	 * @param $subject
+	 * @param $body
+	 *
+	 * @return bool
+	 * @throws Exception
+	 * @throws phpmailerException
+	 */
+	public function sendMailWithPHPMailer($user_email, $from_email, $from_name, $subject, $body)
+	{
+		$mail = new PHPMailer;
+
+		// if you want to send mail via PHPMailer using SMTP credentials
+		if (Config::get('EMAIL_USE_SMTP')) {
+			// set PHPMailer to use SMTP
+			$mail->IsSMTP();
+			// 0 = off, 1 = commands, 2 = commands and data, perfect to see SMTP errors
+			$mail->SMTPDebug = 0;
+			// enable SMTP authentication
+			$mail->SMTPAuth = Config::get('EMAIL_SMTP_AUTH');
+			// encryption
+			if (Config::get('EMAIL_SMTP_ENCRYPTION')) {
+				$mail->SMTPSecure = Config::get('EMAIL_SMTP_ENCRYPTION');
+			}
+			// set SMTP provider's credentials
+			$mail->Host = Config::get('EMAIL_SMTP_HOST');
+			$mail->Username = Config::get('EMAIL_SMTP_USERNAME');
+			$mail->Password = Config::get('EMAIL_SMTP_PASSWORD');
+			$mail->Port = Config::get('EMAIL_SMTP_PORT');
+		} else {
+			$mail->IsMail();
+		}
+
+		// fill mail with data
+		$mail->From = $from_email;
+		$mail->FromName = $from_name;
+		$mail->AddAddress($user_email);
+		$mail->Subject = $subject;
+		$mail->Body = $body;
+
+		// try to send mail
+		$mail->Send();
+
+		if ($mail) {
+			return true;
+		} else {
+			// if not successful, copy errors into Mail's error property
+			$this->error = $mail->ErrorInfo;
+			return false;
+		}
+	}
+
+	public function sendMail($user_email, $from_email, $from_name, $subject, $body)
+	{
+		if (Config::get('EMAIL_USED_MAILER') == "phpmailer") {
+			// returns true if successful, false if not
+			return $this->sendMailWithPHPMailer(
+				$user_email, $from_email, $from_name, $subject, $body
+			);
+		}
+
+		if (Config::get('EMAIL_USED_MAILER') == "swiftmailer") {
+			return $this->sendMailWithSwiftMailer();
+		}
+
+		if (Config::get('EMAIL_USED_MAILER') == "native") {
+			return $this->sendMailWithNativeMailFunction();
+		}
+	}
+
+	public function getError()
+	{
+		return $this->error;
+	}
+}