* * @license AGPL-3.0 * * This code is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License, version 3, * as published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License, version 3, * along with this program. If not, see * */ namespace OC\Mail; use OCP\Defaults; use OCP\IConfig; use OCP\IL10N; use OCP\IURLGenerator; use OCP\Mail\IEMailTemplate; use OCP\Mail\IMailer; use OCP\ILogger; /** * Class Mailer provides some basic functions to create a mail message that can be used in combination with * \OC\Mail\Message. * * Example usage: * * $mailer = \OC::$server->getMailer(); * $message = $mailer->createMessage(); * $message->setSubject('Your Subject'); * $message->setFrom(array('cloud@domain.org' => 'ownCloud Notifier'); * $message->setTo(array('recipient@domain.org' => 'Recipient'); * $message->setBody('The message text'); * $mailer->send($message); * * This message can then be passed to send() of \OC\Mail\Mailer * * @package OC\Mail */ class Mailer implements IMailer { /** @var \Swift_SmtpTransport|\Swift_SendmailTransport|\Swift_MailTransport Cached transport */ private $instance = null; /** @var IConfig */ private $config; /** @var ILogger */ private $logger; /** @var Defaults */ private $defaults; /** @var IURLGenerator */ private $urlGenerator; /** @var IL10N */ private $l10n; /** * @param IConfig $config * @param ILogger $logger * @param Defaults $defaults * @param IURLGenerator $urlGenerator * @param IL10N $l10n */ public function __construct(IConfig $config, ILogger $logger, Defaults $defaults, IURLGenerator $urlGenerator, IL10N $l10n) { $this->config = $config; $this->logger = $logger; $this->defaults = $defaults; $this->urlGenerator = $urlGenerator; $this->l10n = $l10n; } /** * Creates a new message object that can be passed to send() * * @return Message */ public function createMessage() { return new Message(new \Swift_Message()); } /** * Creates a new email template object * * @param string $emailId * @param array $data * @return IEMailTemplate * @since 12.0.0 */ public function createEMailTemplate($emailId, array $data = []) { $class = $this->config->getSystemValue('mail_template_class', ''); if ($class !== '' && class_exists($class) && is_a($class, EMailTemplate::class, true)) { return new $class( $this->defaults, $this->urlGenerator, $this->l10n, $emailId, $data ); } return new EMailTemplate( $this->defaults, $this->urlGenerator, $this->l10n, $emailId, $data ); } /** * Send the specified message. Also sets the from address to the value defined in config.php * if no-one has been passed. * * @param Message $message Message to send * @return string[] Array with failed recipients. Be aware that this depends on the used mail backend and * therefore should be considered * @throws \Exception In case it was not possible to send the message. (for example if an invalid mail address * has been supplied.) */ public function send(Message $message) { $debugMode = $this->config->getSystemValue('mail_smtpdebug', false); if (empty($message->getFrom())) { $message->setFrom([\OCP\Util::getDefaultEmailAddress($this->defaults->getName()) => $this->defaults->getName()]); } $failedRecipients = []; $mailer = $this->getInstance(); // Enable logger if debug mode is enabled if($debugMode) { $mailLogger = new \Swift_Plugins_Loggers_ArrayLogger(); $mailer->registerPlugin(new \Swift_Plugins_LoggerPlugin($mailLogger)); } $mailer->send($message->getSwiftMessage(), $failedRecipients); // Debugging logging $logMessage = sprintf('Sent mail to "%s" with subject "%s"', print_r($message->getTo(), true), $message->getSubject()); $this->logger->debug($logMessage, ['app' => 'core']); if($debugMode && isset($mailLogger)) { $this->logger->debug($mailLogger->dump(), ['app' => 'core']); } return $failedRecipients; } /** * Checks if an e-mail address is valid * * @param string $email Email address to be validated * @return bool True if the mail address is valid, false otherwise */ public function validateMailAddress($email) { return \Swift_Validate::email($this->convertEmail($email)); } /** * SwiftMailer does currently not work with IDN domains, this function therefore converts the domains * * FIXME: Remove this once SwiftMailer supports IDN * * @param string $email * @return string Converted mail address if `idn_to_ascii` exists */ protected function convertEmail($email) { if (!function_exists('idn_to_ascii') || strpos($email, '@') === false) { return $email; } list($name, $domain) = explode('@', $email, 2); $domain = idn_to_ascii($domain, 0,INTL_IDNA_VARIANT_UTS46); return $name.'@'.$domain; } /** * Returns whatever transport is configured within the config * * @return \Swift_SmtpTransport|\Swift_SendmailTransport|\Swift_MailTransport */ protected function getInstance() { if (!is_null($this->instance)) { return $this->instance; } switch ($this->config->getSystemValue('mail_smtpmode', 'php')) { case 'smtp': $this->instance = $this->getSmtpInstance(); break; case 'sendmail': // FIXME: Move into the return statement but requires proper testing // for SMTP and mail as well. Thus not really doable for a // minor release. $this->instance = \Swift_Mailer::newInstance($this->getSendMailInstance()); break; default: $this->instance = $this->getMailInstance(); break; } return $this->instance; } /** * Returns the SMTP transport * * @return \Swift_SmtpTransport */ protected function getSmtpInstance() { $transport = \Swift_SmtpTransport::newInstance(); $transport->setTimeout($this->config->getSystemValue('mail_smtptimeout', 10)); $transport->setHost($this->config->getSystemValue('mail_smtphost', '127.0.0.1')); $transport->setPort($this->config->getSystemValue('mail_smtpport', 25)); if ($this->config->getSystemValue('mail_smtpauth', false)) { $transport->setUsername($this->config->getSystemValue('mail_smtpname', '')); $transport->setPassword($this->config->getSystemValue('mail_smtppassword', '')); $transport->setAuthMode($this->config->getSystemValue('mail_smtpauthtype', 'LOGIN')); } $smtpSecurity = $this->config->getSystemValue('mail_smtpsecure', ''); if (!empty($smtpSecurity)) { $transport->setEncryption($smtpSecurity); } $transport->start(); return $transport; } /** * Returns the sendmail transport * * @return \Swift_SendmailTransport */ protected function getSendMailInstance() { switch ($this->config->getSystemValue('mail_smtpmode', 'php')) { case 'qmail': $binaryPath = '/var/qmail/bin/sendmail'; break; default: $binaryPath = '/usr/sbin/sendmail'; break; } return \Swift_SendmailTransport::newInstance($binaryPath . ' -bs'); } /** * Returns the mail transport * * @return \Swift_MailTransport */ protected function getMailInstance() { return \Swift_MailTransport::newInstance(); } }