(PHP 4, PHP 5, PHP 7, PHP 8)
imap_mail_compose — 根據指定的信封和主體區段建立 MIME 訊息
envelope標頭欄位的關聯式陣列。有效的鍵值包含："remail"、"return_path"、"date"、"from"、"reply_to"、"in_reply_to"、"subject"、"to"、"cc"、"bcc" 和 "message_id"，這些鍵值會將各自的訊息標頭設定為指定的 字串。要設定額外的標頭，可以使用 "custom_headers" 鍵值，它需要一個包含這些標頭的陣列，例如 ["User-Agent: My Mail Client"]。
bodies一個索引式陣列，包含訊息的本文。第一個本文是訊息的主要本文；只有當它的類型為 TYPEMULTIPART 時，才會處理後續的本文；這些本文構成部件的本文。
| 鍵值 | 類型 | 說明 |
|---|---|---|
type |
int | MIME 類型。其中一個：TYPETEXT（預設）、TYPEMULTIPART、TYPEMESSAGE、TYPEAPPLICATION、TYPEAUDIO、TYPEIMAGE、TYPEMODEL 或 TYPEOTHER。 |
encoding |
int | Content-Transfer-Encoding。其中一個：ENC7BIT（預設）、ENC8BIT、ENCBINARY、ENCBASE64、ENCQUOTEDPRINTABLE 或 ENCOTHER。 |
charset |
字串 | MIME 類型的字元集參數。 |
type.parameters |
陣列 | 一個包含 Content-Type 參數名稱及其值的關聯式 陣列。 |
subtype |
字串 | MIME 子類型，例如 TYPEIMAGE 的 'jpeg'。 |
id |
字串 | Content-ID。 |
description |
字串 | Content-Description。 |
disposition.type |
字串 | Content-Disposition，例如 'attachment'。 |
disposition |
陣列 | 一個包含 Content-Disposition 參數名稱及其值的關聯式 陣列。 |
contents.data |
字串 | 有效負載。 |
lines |
int | 有效負載的大小（以行計）。 |
bytes |
int | 有效負載的大小（以位元組計）。 |
md5 |
字串 | 有效負載的 MD5 校驗和。 |
範例 #1 imap_mail_compose() 範例
<?php
$envelope["from"]= "joe@example.com";
$envelope["to"] = "foo@example.com";
$envelope["cc"] = "bar@example.com";
$part1["type"] = TYPEMULTIPART;
$part1["subtype"] = "mixed";
$filename = "/tmp/imap.c.gz";
$fp = fopen($filename, "r");
$contents = fread($fp, filesize($filename));
fclose($fp);
$part2["type"] = TYPEAPPLICATION;
$part2["encoding"] = ENCBINARY;
$part2["subtype"] = "octet-stream";
$part2["description"] = basename($filename);
$part2["contents.data"] = $contents;
$part3["type"] = TYPETEXT;
$part3["subtype"] = "plain";
$part3["description"] = "description3";
$part3["contents.data"] = "contents.data3\n\n\n\t";
$body[1] = $part1;
$body[2] = $part2;
$body[3] = $part3;
echo nl2br(imap_mail_compose($envelope, $body));
?>custom_headers 信封的說明文件有誤導性。它實際上不是一個「關聯式陣列」，而是一個普通的標頭陣列。
這是錯誤的
<?php
$envelope = [
//...
"custom_headers" => [
"X-SES-CONFIGURATION-SET" => "example",
"X-SES-MESSAGE-TAGS" => "emailType=example"
]
];
?>
這是正確的
<?php
$envelope = [
//...
"custom_headers" => [
"X-SES-CONFIGURATION-SET: example",
"X-SES-MESSAGE-TAGS: emailType=example"
]
];
?>上述文件沒有提到您可以使用索引 ["charset"] 來設定訊息部分的字元集。
範例
$part1["type"]= "TEXT";
$part1["subtype"]="PLAIN";
$part1["charset"] = "koi8-r";
以俄語-koi8 編碼傳送訊息。
Scott =)如果您想傳送此函式的輸出，只需將其用於 imap_mail() 或 mail() 的標頭參數即可。請記住，這些函式會設定 To: 和 Subject: 標頭，因此將它們包含在信封中會產生重複的項目。