ttrss/classes/mailer.php

<?php
class Mailer {
	// TODO: class properties can be switched to PHP typing if/when the minimum PHP_VERSION is raised to 7.4.0+
	/** @var string */
	private $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", array_merge($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;
	}
}