核心:方法
我们将MIME信息头的生成,MIME段头的生成和最终的
邮件消息的生成分成几个模块。方法的实现是直接从我们前面遇到的MIME基础而来的。
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 .= ";\r\n\tcharset=".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(\r\n)序列结束。
接着,我们看一下fattach()方法,fattach()与attach()相似,但是它使用一个文件名作为它的第一个参数(作为attach()中$data的替换)。这个方法只是一个封装,以便调用者可以用一个文件来调用fattach。fattach()然后将文件读出,接着调用attach()来追加数据。这个方法在失败时返回0,可以在$errstr 变量中找到解释或者当成功时,返回文件附件在$mimeparts数组中的索引号。
我们现在已经
开发了附加数据的功能,对它们进行编码并且将单独的MIME段放在私有数组中。还需要完成的工作是:
完成MIME的各个段创建包含MIME信息头的邮件信息头,邮件原始的信息头(如To:, From:等等)并且包括任何用户定义的头。
在头后面追加完整的MIME段,这样一个完整的邮件包就生成了。