diff options
author | Andrew Dolgov <[email protected]> | 2023-10-25 12:55:09 +0300 |
---|---|---|
committer | Andrew Dolgov <[email protected]> | 2023-10-25 12:55:09 +0300 |
commit | 865ecc87963dc3b26e66296616eef2a1cc41ac3f (patch) | |
tree | bf2ecd8a391103bdb2c8b70cd33c47467310754b /classes/Mailer.php | |
parent | 0a5507d3bd79d04c860455664f919bf8e7274fda (diff) |
move to psr-4 autoloader
Diffstat (limited to 'classes/Mailer.php')
-rw-r--r-- | classes/Mailer.php | 65 |
1 files changed, 65 insertions, 0 deletions
diff --git a/classes/Mailer.php b/classes/Mailer.php new file mode 100644 index 000000000..ac5c641eb --- /dev/null +++ b/classes/Mailer.php @@ -0,0 +1,65 @@ +<?php +class Mailer { + private string $last_error = ""; + + /** + * @param array<string, mixed> $params + * @return bool|int bool if the default mail function handled the request, otherwise an int as described in Mailer#mail() + */ + function mail(array $params) { + + $to_name = $params["to_name"] ?? ""; + $to_address = $params["to_address"]; + $subject = $params["subject"]; + $message = $params["message"]; + $message_html = $params["message_html"] ?? ""; + $from_name = $params["from_name"] ?? Config::get(Config::SMTP_FROM_NAME); + $from_address = $params["from_address"] ?? Config::get(Config::SMTP_FROM_ADDRESS); + $additional_headers = $params["headers"] ?? []; + + $from_combined = $from_name ? "$from_name <$from_address>" : $from_address; + $to_combined = $to_name ? "$to_name <$to_address>" : $to_address; + + if (Config::get(Config::LOG_SENT_MAIL)) + Logger::log(E_USER_NOTICE, "Sending mail from $from_combined to $to_combined [$subject]: $message"); + + // HOOK_SEND_MAIL plugin instructions: + // 1. return 1 or true if mail is handled + // 2. return -1 if there's been a fatal error and no further action is allowed + // 3. any other return value will allow cycling to the next handler and, eventually, to default mail() function + // 4. set error message if needed via passed Mailer instance function set_error() + + $hooks_tried = 0; + + foreach (PluginHost::getInstance()->get_hooks(PluginHost::HOOK_SEND_MAIL) as $p) { + $rc = $p->hook_send_mail($this, $params); + + if ($rc == 1) + return $rc; + + if ($rc == -1) + return 0; + + ++$hooks_tried; + } + + $headers = [ "From: $from_combined", "Content-Type: text/plain; charset=UTF-8" ]; + + $rc = mail($to_combined, $subject, $message, implode("\r\n", [...$headers, ...$additional_headers])); + + if (!$rc) { + $this->set_error(error_get_last()['message'] ?? T_sprintf("Unknown error while sending mail. Hooks tried: %d.", $hooks_tried)); + } + + return $rc; + } + + function set_error(string $message): void { + $this->last_error = $message; + user_error("Error sending mail: $message", E_USER_WARNING); + } + + function error(): string { + return $this->last_error; + } +} |