. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Services; use Exception; use Fisharebest\Webtrees\Contracts\UserInterface; use Fisharebest\Webtrees\I18N; use Fisharebest\Webtrees\Log; use Fisharebest\Webtrees\Site; use Swift_Mailer; use Swift_Message; use Swift_NullTransport; use Swift_SendmailTransport; use Swift_Signers_DKIMSigner; use Swift_SmtpTransport; use Swift_Transport; use Throwable; use function filter_var; use function function_exists; use function gethostbyaddr; use function gethostbyname; use function gethostname; use function str_replace; use function strrchr; use function substr; use const FILTER_VALIDATE_DOMAIN; use const FILTER_VALIDATE_EMAIL; /** * Send emails. */ class EmailService { /** * Send an external email message * Caution! gmail may rewrite the "From" header unless you have added the address to your account. * * @param UserInterface $from * @param UserInterface $to * @param UserInterface $reply_to * @param string $subject * @param string $message_text * @param string $message_html * * @return bool */ public function send(UserInterface $from, UserInterface $to, UserInterface $reply_to, string $subject, string $message_text, string $message_html): bool { // Mail needs MSDOS line endings $message_text = str_replace("\n", "\r\n", $message_text); $message_html = str_replace("\n", "\r\n", $message_html); // Special accounts do not have an email address. Use the system one. $from_email = $from->email() ?: $this->senderEmail(); $reply_to_email = $reply_to->email() ?: $this->senderEmail(); $message = (new Swift_Message()) ->setSubject($subject) ->setFrom($from_email, $from->realName()) ->setTo($to->email(), $to->realName()) ->setBody($message_html, 'text/html'); if ($from_email !== $reply_to_email) { $message->setReplyTo($reply_to_email, $reply_to->realName()); } $dkim_domain = Site::getPreference('DKIM_DOMAIN'); $dkim_selector = Site::getPreference('DKIM_SELECTOR'); $dkim_key = Site::getPreference('DKIM_KEY'); if ($dkim_domain !== '' && $dkim_selector !== '' && $dkim_key !== '') { $signer = new Swift_Signers_DKIMSigner($dkim_key, $dkim_domain, $dkim_selector); $signer ->setHeaderCanon('relaxed') ->setBodyCanon('relaxed'); $message->attachSigner($signer); } else { // DKIM body hashes don't work with multipart/alternative content. $message->addPart($message_text, 'text/plain'); } $mailer = new Swift_Mailer($this->transport()); try { $mailer->send($message); } catch (Exception $ex) { Log::addErrorLog('MailService: ' . $ex->getMessage()); return false; } return true; } /** * Create a transport mechanism for sending mail * * @return Swift_Transport */ private function transport(): Swift_Transport { switch (Site::getPreference('SMTP_ACTIVE')) { case 'sendmail': // Local sendmail (requires PHP proc_* functions) return new Swift_SendmailTransport(); case 'external': // SMTP $smtp_host = Site::getPreference('SMTP_HOST'); $smtp_port = (int) Site::getPreference('SMTP_PORT', '25'); $smtp_auth = (bool) Site::getPreference('SMTP_AUTH'); $smtp_user = Site::getPreference('SMTP_AUTH_USER'); $smtp_pass = Site::getPreference('SMTP_AUTH_PASS'); $smtp_encr = Site::getPreference('SMTP_SSL'); if ($smtp_encr === 'none') { $smtp_encr = null; } $transport = new Swift_SmtpTransport($smtp_host, $smtp_port, $smtp_encr); $transport->setLocalDomain($this->localDomain()); if ($smtp_auth) { $transport ->setUsername($smtp_user) ->setPassword($smtp_pass); } return $transport; default: // For testing return new Swift_NullTransport(); } } /** * Where are we sending mail from? * * @return string */ public function localDomain(): string { $local_domain = Site::getPreference('SMTP_HELO'); try { // Look ourself up using DNS. $default = gethostbyaddr(gethostbyname(gethostname())); } catch (Throwable $ex) { $default = 'localhost'; } return $local_domain ?: $default; } /** * Who are we sending mail from? * * @return string */ public function senderEmail(): string { $sender = Site::getPreference('SMTP_FROM_NAME'); $default = 'no-reply@' . $this->localDomain(); return $sender ?: $default; } /** * Many mail relays require a valid sender email. * * @param string $email * * @return bool */ public function isValidEmail(string $email): bool { $at_domain = strrchr($email, '@'); if ($at_domain === false) { return false; } $domain = substr($at_domain, 1); $email_valid = filter_var($email, FILTER_VALIDATE_EMAIL) !== false; $domain_valid = filter_var($domain, FILTER_VALIDATE_DOMAIN) !== false; return $email_valid && $domain_valid; } /** * A list SSL modes (e.g. for an edit control). * * @return string[] */ public function mailSslOptions(): array { return [ 'none' => I18N::translate('none'), /* I18N: Secure Sockets Layer - a secure communications protocol*/ 'ssl' => I18N::translate('ssl'), /* I18N: Transport Layer Security - a secure communications protocol */ 'tls' => I18N::translate('tls'), ]; } /** * A list SSL modes (e.g. for an edit control). * * @return string[] */ public function mailTransportOptions(): array { $options = [ /* I18N: "sendmail" is the name of some mail software */ 'sendmail' => I18N::translate('Use sendmail to send messages'), 'external' => I18N::translate('Use SMTP to send messages'), ]; if (!function_exists('proc_open')) { unset($options['sendmail']); } return $options; } }