imap_mail_compose
(PHP 4, PHP 5, PHP 7, PHP 8)
imap_mail_compose — Create a MIME message based on given envelope and body sections
說明
$envelope
, array $bodies
): string|false
Create a MIME message based on the given envelope
and bodies
sections.
參數
-
envelope
-
An associative array of header fields. Valid keys are:
"remail"
,"return_path"
,"date"
,"from"
,"reply_to"
,"in_reply_to"
,"subject"
,"to"
,"cc"
,"bcc"
and"message_id"
, which set the respective message headers to the given string. To set additional headers, the key"custom_headers"
is supported, which expects an array of those headers, e.g.["User-Agent: My Mail Client"]
. -
bodies
-
An indexed array of bodies. The first body is the main body of the message; only if it has a type of
TYPEMULTIPART
, further bodies are processed; these bodies constitute the bodies of the parts.Body Array Structure Key Type Description type
int The MIME type. One of TYPETEXT
(default),TYPEMULTIPART
,TYPEMESSAGE
,TYPEAPPLICATION
,TYPEAUDIO
,TYPEIMAGE
,TYPEMODEL
orTYPEOTHER
.encoding
int The Content-Transfer-Encoding
. One ofENC7BIT
(default),ENC8BIT
,ENCBINARY
,ENCBASE64
,ENCQUOTEDPRINTABLE
orENCOTHER
.charset
string The charset parameter of the MIME type. type.parameters
array An associative array of Content-Type
parameter names and their values.subtype
string The MIME subtype, e.g. 'jpeg'
forTYPEIMAGE
.id
string The Content-ID
.description
string The Content-Description
.disposition.type
string The Content-Disposition
, e.g.'attachment'
.disposition
array An associative array of Content-Disposition
parameter names and values.contents.data
string The payload. lines
int The size of the payload in lines. bytes
int The size of the payload in bytes. md5
string The MD5 checksum of the payload.
返回值
Returns the MIME message as string, 或者在失敗時返回 false
.
範例
示例 #1 imap_mail_compose() example
<?php
$envelope["from"]= "[email protected]";
$envelope["to"] = "[email protected]";
$envelope["cc"] = "[email protected]";
$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));
?>