介面 yii\mail\MessageInterface
實作於 | yii\mail\BaseMessage |
---|---|
自版本起可用 | 2.0 |
原始碼 | https://github.com/yiisoft/yii2/blob/master/framework/mail/MessageInterface.php |
MessageInterface 是郵件訊息類別應實作的介面。
訊息代表電子郵件的設定與內容,例如寄件者、收件者、主旨、內文等等。
訊息由 mailer 傳送,如下所示:
Yii::$app->mailer->compose()
->setFrom('from@domain.com')
->setTo($form->email)
->setSubject($form->subject)
->setTextBody('Plain text content')
->setHtmlBody('<b>HTML content</b>')
->send();
另請參閱 yii\mail\MailerInterface。
公用方法
方法詳細資訊
將現有檔案附加到電子郵件訊息。
public abstract $this attach ( $fileName, array $options = [] ) | ||
$fileName | string |
完整檔案名稱 |
$options | array |
嵌入檔案的選項。有效的選項為
|
return | $this |
自身參考。 |
---|
public function attach($fileName, array $options = []);
將指定的內容作為檔案附加到電子郵件訊息。
public abstract $this attachContent ( $content, array $options = [] ) | ||
$content | string |
附件檔案內容。 |
$options | array |
嵌入檔案的選項。有效的選項為
|
return | $this |
自身參考。 |
---|
public function attachContent($content, array $options = []);
附加檔案並傳回其 CID 來源。
當在訊息中嵌入圖片或其他資料時,應使用此方法。
public abstract string embed ( $fileName, array $options = [] ) | ||
$fileName | string |
檔案名稱。 |
$options | array |
嵌入檔案的選項。有效的選項為
|
return | string |
附件 CID。 |
---|
public function embed($fileName, array $options = []);
將內容作為檔案附加並傳回其 CID 來源。
當在訊息中嵌入圖片或其他資料時,應使用此方法。
public abstract string embedContent ( $content, array $options = [] ) | ||
$content | string |
附件檔案內容。 |
$options | array |
嵌入檔案的選項。有效的選項為
|
return | string |
附件 CID。 |
---|
public function embedContent($content, array $options = []);
傳回此訊息的密件副本 (Bcc) 地址。
public abstract string|array getBcc ( ) | ||
return | string|array |
此訊息的密件副本 (hidden copy receiver) 地址。 |
---|
public function getBcc();
傳回此訊息的副本 (Cc) 地址。
public abstract string|array getCc ( ) | ||
return | string|array |
此訊息的副本 (additional copy receiver) 地址。 |
---|
public function getCc();
傳回此訊息的字元集。
public abstract string getCharset ( ) | ||
return | string |
此訊息的字元集。 |
---|
public function getCharset();
傳回訊息寄件者。
public abstract string|array getFrom ( ) | ||
return | string|array |
寄件者 |
---|
public function getFrom();
傳回此訊息的回覆地址。
public abstract string|array getReplyTo ( ) | ||
return | string|array |
此訊息的回覆地址。 |
---|
public function getReplyTo();
傳送此電子郵件訊息。
public abstract boolean send ( yii\mail\MailerInterface $mailer = null ) | ||
$mailer | yii\mail\MailerInterface|null |
應該用於發送此訊息的郵件器。如果為 null,則將改為使用 "mailer" 應用程式組件。 |
return | boolean |
此訊息是否成功發送。 |
---|
public function send(MailerInterface $mailer = null);
設定此訊息的密件副本 (Bcc) 地址。
public abstract $this setBcc ( $bcc ) | ||
$bcc | string|array |
密件副本收件者電子郵件地址。如果有多位收件者應接收此訊息,您可以傳遞地址陣列。您也可以使用以下格式指定電子郵件地址以外的收件者名稱: |
return | $this |
自身參考。 |
---|
public function setBcc($bcc);
設定此訊息的副本 (Cc) 地址。
public abstract $this setCc ( $cc ) | ||
$cc | string|array |
副本收件者電子郵件地址。如果有多位收件者應接收此訊息,您可以傳遞地址陣列。您也可以使用以下格式指定電子郵件地址以外的收件者名稱: |
return | $this |
自身參考。 |
---|
public function setCc($cc);
設定此訊息的字元集。
public abstract $this setCharset ( $charset ) | ||
$charset | string |
字元集名稱。 |
return | $this |
自身參考。 |
---|
public function setCharset($charset);
設定訊息寄件者。
public abstract $this setFrom ( $from ) | ||
$from | string|array |
寄件者電子郵件地址。如果此訊息來自多人,您可以傳遞地址陣列。您也可以使用以下格式指定電子郵件地址以外的寄件者名稱: |
return | $this |
自身參考。 |
---|
public function setFrom($from);
設定訊息 HTML 內容。
public abstract $this setHtmlBody ( $html ) | ||
$html | string |
訊息 HTML 內容。 |
return | $this |
自身參考。 |
---|
public function setHtmlBody($html);
設定此訊息的回覆地址。
public abstract $this setReplyTo ( $replyTo ) | ||
$replyTo | string|array |
回覆地址。如果此訊息應回覆給多人,您可以傳遞地址陣列。您也可以使用以下格式指定電子郵件地址以外的回覆名稱: |
return | $this |
自身參考。 |
---|
public function setReplyTo($replyTo);
設定訊息主旨。
public abstract $this setSubject ( $subject ) | ||
$subject | string |
訊息主旨 |
return | $this |
自身參考。 |
---|
public function setSubject($subject);
設定訊息純文字內容。
public abstract $this setTextBody ( $text ) | ||
$text | string |
訊息純文字內容。 |
return | $this |
自身參考。 |
---|
public function setTextBody($text);
註冊 或 登入 以發表評論。