用PHP发送MIME邮件(四)

March 23,2004

核心：方法
　　我们将MIME信息头的生成，MIME段头的生成和最终的邮件消息的生成分成几个模块。方法的实现是直接从我们前面遇到的MIME基础而来的。

<?php

function attach($data, $description = "", $contenttype = OCTET,
$encoding = BASE64, $disp = '') {
if (empty($data))
return 0;
if (trim($contenttype) == '')
$contenttype = OCTET ;
if (trim($encoding) == '')
$encoding = BASE64;
if ($encoding == BIT7)
$emsg = $data;
elseif ($encoding == QP)
$emsg = $$this->qp_func($data);
elseif ($encoding == BASE64) {
if (!$this->base64_func) # 检查是否有用户自动定函数
$emsg = base64_encode($data);
else
$emsg = $$this->base64_func($data);
}
$emsg = chunk_split($emsg);
//检查是否content-type是text/plain并且如果没有指定charset，追加缺省的CHARSET
if (preg_match("!^".TEXT."!i", $contenttype) &&
!preg_match("!;charset=!i", $contenttype))
$contenttype .= ";
charset=".CHARSET ;
$msg = sprintf("Content-Type: %sContent-Transfer-Encoding: %s%s%s%s",
$contenttype.CRLF,
$encoding.CRLF,
((($description) && (BODY != $description))?"Content-Description:
$description".CRLF:""),
($disp?"Content-Disposition: $disp".CRLF:""),
CRLF.$emsg.CRLF);
BODY==$description? $this->mimeparts[0] = $msg: $this->mimeparts[] = $msg
;
return sizeof($this->mimeparts);
}

?>

　　让我们仔细地看一下这个方法（对于其它的大部分方法也将如此）：

这个方法使用的参数有：
所附的实际数据（$data）
与Content-Description头相应的数据描述（$description）
将用在Content-Type头中的数据content-type值（$contentype）
用在Content-Transfer-Encoding中的编码值（$encoding）
用在Content-Disposition头$disp中的布局值，可以是INLINE或ATTACH，两个都是常量
如BASE64，TEXT这样的值等等，作为常量被定义在附加的.def文件中。
使用$encoding值来决定需要用哪种编码方式对数据进行编码。有效的值是BIT7(或7bit)，QP或BASE64。
这个函数同时也检查了是否用户要使用他/她自已的BASE64或QP函数。在写这篇文章时，在我们的类中
只有BIT7和BASE64被实现了，然而，你可以传递你自已的quoted-printable
函数来使用，通过在前面
讨论的$qp_func类变量。
在编码处理之后，你会注意到对编码的信息使用了chunk_split()。这个函数根据可选长度将字符串分
割成小段。因为我们没有指出长度，缺省长度使用76。这个非常附合邮件处理的习惯。
接着，如果$contenttype参数包含text/plain，则必须给出"charset="
参数的值。它的缺省值被定义
在常量CHARSET中，值为us-ascii。注意当头使用参数值传递时，在头与参数之间必须有一个分号（;）。
例如，Content-Type: text/plain; charset=us-ascii
如果其它MIME段头各自的值被传递给这个方法，这些段头被创建。毕竟我们不想拥有一个没有描述的
Content-Description头。在创建这些头之后，我们追加上经过编码的数据部分信息。（检查一下方法
中的sprintf()语句）。
同样，注意我们使用了一个叫BODY（又是一个常量）的特别描述字段。这就是我们用在类实现中的东西。
如果描述字段与BODY一样，我们将其赋给$mimeheaders数组中的第一个元素。对于这个请多读几遍。

attach() 返回$mimeparts数组的当前大小，用在调用脚本的引用中。通过这种方法就可以知道一个附
件"X"存在哪一个索引中（实际返回的值要比在数组中的索引小1）
注意所有的头必须用一个CRLF（
）序列结束。
　　接着，我们看一下fattach()方法，fattach()与attach()相似，但是它使用一个文件名作为它的第一个
参数（作为attach()中$data的替换）。这个方法只是一个封装，以便调用者可以用一个文件来调用fattach。
fattach()然后将文件读出，接着调用attach()来追加数据。这个方法在失败时返回0，可以在$errstr
变量
中找到解释或者当成功时，返回文件附件在$mimeparts数组中的索引号。

　　我们现在已经开发了附加数据的功能，对它们进行编码并且将单独的MIME段放在私有数组中。还需要完
成的工作是：

完成MIME的各个段
创建包含MIME信息头的邮件信息头，邮件原始的信息头（如To:,From:等等）并且包括任何用户定义
的头。
在头后面追加完整的MIME段，这样一个完整的邮件包就生成了。