[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  abstract class PhabricatorMailImplementationAdapter {
   4  
   5    abstract public function setFrom($email, $name = '');
   6    abstract public function addReplyTo($email, $name = '');
   7    abstract public function addTos(array $emails);
   8    abstract public function addCCs(array $emails);
   9    abstract public function addAttachment($data, $filename, $mimetype);
  10    abstract public function addHeader($header_name, $header_value);
  11    abstract public function setBody($plaintext_body);
  12    abstract public function setHTMLBody($html_body);
  13    abstract public function setSubject($subject);
  14  
  15    /**
  16     * Some mailers, notably Amazon SES, do not support us setting a specific
  17     * Message-ID header.
  18     */
  19    abstract public function supportsMessageIDHeader();
  20  
  21  
  22    /**
  23     * Send the message. Generally, this means connecting to some service and
  24     * handing data to it.
  25     *
  26     * If the adapter determines that the mail will never be deliverable, it
  27     * should throw a @{class:PhabricatorMetaMTAPermanentFailureException}.
  28     *
  29     * For temporary failures, throw some other exception or return `false`.
  30     *
  31     * @return bool True on success.
  32     */
  33    abstract public function send();
  34  
  35  }