发信人: jackyz()
整理人: dalasthunder(2002-07-25 06:30:13), 站内信件
|
用PHP发送MIME邮件
---------------------------------------------------------------------
作者：Kartic Krishnamurthy
译者：limodou
已经厌倦了给你的朋友和客户发送那些单调乏味的文本通知和信件了吗？曾
经考虑过发送附件或在邮中嵌入HTML吧。
答案就是MIME。接下来的几页解释了MIME的基础知识，创建符合MIME的信息
，然后用一个可以工作的PHP类结束，这个类实现了发送符合MIME邮件。注意对调
用脚本，调用者等等的引用表示使用了将要开发的类的脚本，客户程序/MUA等等
表示邮件阅读的客户程序或邮件使用代理程序。
一些MIME基础
MIME表示多用途Internet邮件扩允协议。MIME扩允了基本的面向文本的Inte
rnet邮件系统，以便可以在消息中包含二进制附件。
MIME利用了一个事实就是，RFC 822在消息体的内容中做了一点限制：唯一的
限制就是只能使用简单的ASCII文本。所以，MIME信息由正常的Internet文本邮件
组成，文本邮件拥有一些特别的符合RFC 822的信息头和格式化过的信息体（用A
SCII 的子集来表示的附件）。这些MIME头给出了一种在邮件中表示附件的特别的
方法。
MIME信息的剖析
一个普通的文本邮件的信息包含一个头部分（To: From: Subject: 等等）和
一个体部分（Hello Mr.,等等）。在一个符合MIME的信息中，也包含一个信息头
并不奇怪，邮件的各个部分叫做MIME段，每段前也缀以一个特别的头。MIME邮件
只是基于RFC 822邮件的一个扩展。然而它有着自已的RFC规范集。
头字段
MIME头根据在邮件包中的位置，大体上分为MIME信息头和MIME段头。（译者
：MIME信息头指整个邮件的头，而MIME段头只每个MIME段的头。）
MIME信息头有：
MIME-Version:
这个头提供了所用MIME的版本号。这个值习惯上为1.0。
Content-Type:
它定义了数据的类型，以便数据能被适当的处理。有效的类型有：text，image，
audio，video，applications，multipart和message。注意任何一个二进制附件
都应该被叫做application/octet-stream。这个头的一些用例为：image/jpg, a
pplication/mswork，multipart/mixed，这只是很少的一部分。
Content-Transfer-Encoding:
这是所有头中最重要的一个，因为它说明了对数据所执行的编码方式，客户/MUA
将用它对附件进行解码。对于每个附件，可以使用7bit，8bit，binary ，quot
ed-printable，base64和custom中的一种编码方式。7bit编码是用在US ASCII字
符集上的常用的一种编码方式，也就是，保持它的原样。8bit 和binary编码一般
不用。对人类可读的标准文本，如果传输要经过对格式有影响的网关时对其进行
保护，可以使用quoted printable 。Base64是一种通用方法，在需要决定使用哪
一种编码方法时，它提供了一个不用费脑子的选择；它通常用在二进制，非文本
数据上。注意，任何非7bit 数据必须用一种模式编码，这样它就可以通过Inter
net邮件网关！
Content-ID:
如果Content-Type是message/external-body或multipart/alternative时，这个
头就有用了。它超出了本文的范围。
Content-Description:
这是一个可选的头。它是任何信息段内容的自由文本描述。描述必须使用us-asc
ii码。
Content-Disposition:
一个试验性的头，它用于给客户程序/MUA提供提示，来决定是否在行内显示附件
或作为单独的附件。
MIME段头（出现在实际的MIME附件部分的头），除了MIME-Version头，可以
拥有以上任何头字段。如果一个MIME头是信息块的一部分，它将作用于整个信息
体。例如，如果Content-Transfer-Encoding显示在信息（指整个信息）头中，它
应用于整个信息体，但是如果它显示在一个MIME段里，它"只能"用于那个段中。
"好，如何创建符合MIME的信息呢？"
通过上面的一般性的描述，让我们现在看一下所谓的MIME信息到底是什么！
最简单的MIME信息
这个信息没有任何段，也就是，没有附件。然而，因为它是一个MIME消息，
它必须有必要的头。
From: [email protected]
To: 'Alex (the Great)' <[email protected]>
Subject: Bucephalus
MIME-Version: 1.0
Hello Alexander,
How's Bucephalus doing?
这里面没有什么，它只是一个简单的拥有MIME头的符合RFC-822 的信息（文
本邮件）。注意，如果没有指定Content-Type头，则假设为Content-Type: text
/plain;charset='us-ascii'!当然，它有些简单，复杂一些的如下：
From: 'Alex (the Great)' <[email protected]>
To: [email protected]
Subject: re: Bucephalus
MIME-Version: 1.0
Content-Type: image/jpg;
name='buce.jpg'
Content-Transfer-Encoding: base64
Content-Description: Take a look at him yourself
<.....base64 encoded jpg image of Bucephalus...>
"嗨，但是我想发送一个word文档和一张我的小狗的图片在同一封邮件中...
！"一个用户说！如果是真的，上面的那个例子就太简单了，并且它没有足够的
内容来支持爱好者和现代邮件处理方面的需要。实际上，许多的邮件客户端软件
甚至不能显示描述字段！
这就是我们所面临的"多部分信息"。
多部分信息（Multipart Messages）
这个概念允许在一封邮件中发送多条项目。例如，假设Alexander想要给php
@php.net发送一封他的马的照片的邮件，同时还附带有马的家族图谱及精彩的说
明！这样一个简单的要求没有多部分消息的概念是无法被满足的。在这种情况下
，我们创建了一个使用Content-Type的信息头的封装来支持邮件的不同部分，以
便收信人得到图片，家族图谱和精彩的说明！
Content-Type 头现在拥有一个"multipart"的值，它表示这是一个完整的邮
件信息并且这个头只封装了信息。而且它还有一个"mixed"的子类型（毕竟图片，
家族图谱和7bit文本信息是不同的类型，对吗？）。
让我们看一下整个图片看上去象：
From: 'Alex (the Great)' <[email protected]>
To: [email protected]
Subject: re: Bucephalus
MIME-Version: 1.0
Content-Type: multipart/mixed;
boundary="XX-1234DED00099A";
Content-Transfer-Encoding: 7bit
This is a MIME Encoded Message
--XX-1234DED00099A
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Hi PHP,
Attached you will find my horse, Bucephalus', pedigree chart and photo
.
Alex
--XX-1234DED00099A
Content-Type: image/jpg;
name="buce.jpg";
Content-Transfer-Encoding: base64
Content-Description: "A photo of Bucephalus"
<.....base64 encoded jpg image of Bucephalus...>
--XX-1234DED00099A
Content-Type: application/octet-stream;
name="pedigree.doc"
Content-Transfer-Encoding: base64
Content-Description: "Pedigree Chart of the great horse"
<.....base64 encoded doc (pedigree.doc) of Bucephalus...>
--XX-1234DED00099A--
哟，看上去很复杂，不是吗？不管怎样，让我们浏览一遍细节吧：
1.如果你注意到了在MIME信息头中的Content-Transfer-Encoding，为"7bit"。因
为Content-Type为multipart/mixed，编码应该是7bit，8bit或二进制中的一种，
7bit是一种广泛使用的格式。
2.象这样一条信息包含了多种信息。客户程序是如何知道JPG图片，文档和普通文
本之间的区别呢？你会注意到在Content-Type后面有一个boundary="XX-1234DED
00099A"参数。这个值用来分离邮件中的不同
部分。它叫做MIME边界标记。边界标记的值必须尽可能的唯一，以免在超出邮件
范围时发生混乱。
3."警告"信息（译者：指"This is a MIME Encoded Message"）在那里是为了让
不符合MIME的客户程序能够把它显示给用户，否则他们就不理解一个空白邮件是
什么意思。
4.现在，回到边界标记。如果你观察这个简单的邮件，会发现边界标记（XX-123
4DED00099A在每一个分都出现了，也就是，在每部分之间都使用了一个边界标记
，然而，每个边界标记都以两个连接符开始。很重要的一点需要注意的就是在最
后一个MIME段的后面，边界标记不仅仅以那两个边接符作为开始，同时也以它俩
作为结束。这一点一定不能忘记，因为它定义了邮件的范围。
5.让我们看一下前两个MIME段：
第一段是普通文本信息，因此Content-Type为text/plain，并且编码为7bit（我
们也可以省略它，因为如果不指明它也会默认为如此）。
第二个就是JPEG图片。相应的表示为Content-Type: image/jpg。name="buce.jp
g"（出现在Content-Type的后面，称之为参数），指出了文件的名字；它就是可
以在客户程序中看到的附件的名字。如果不给出name="buce.jpg" ，描述字段（
如果给出）将作为附件的名字显示出来（然而，在所有客户程序中它不是统一的
做法）。
6.注意JPEG 图片可以在邮件件中被显示出来，如果客户程序可以显示行内附件。
或者，你可以向客户程指明你想如何显示附件。例如，如果存在Content-Dispos
ition: attachment头，JPEG图片将被显示为一个附件图标。
MIME 类
在有了这些基础之后，让我们用PHP创建和实现一个MIME邮件类。在我们的P
HP库函数中，已经有了编码所必须的工具。
MIME类必须能够：
1.增加附件
2.对每一个独立的请求，对所附的数据进行编码
3.创建MIME段/头
4.生成一个包含MIME段/头的完整的邮件
5.将整个邮件作为字符串返回
6.用本地的邮件处理程序进行发送（或选择调用一个SMTP邮件处理程序）
这个类叫做MIME_mail。我们将讨论类的方法，在理论与实际的差距中建立起
桥梁。（阅读建议：LuisArgerich的PHP的面向对象编程：开发大型PHP项目的方
法）。为了便于阅读大部分的注释已经被去掉了。一些方法与类的成员变量只是
用于内部处理，并且已经在下面的注释中被指出来了（同时在初始的类文件中也
指出了）。
<?php
class MIME_mail {
//公有：
var $to;
var $from;
var $subject;
var $body;
var $headers = "";
var $errstr="";
var $base64_func= ''; // 如果未指定使用PHP的base64函数
var $qp_func = ''; // 此时为空
var $mailer = ""; // 将其设为有效的邮件对象的名字
?>
这里有一些公共处理的变量（也就是，可以在脚本中直接操纵的变量）。这
些变量中的大部分都是自说明的。$headers包含了可选的想要发送给邮件处理程
序的头信息。$errstr 是一个包含可读错误字符串的变量，它可以用在调用脚本
中。
$base64_func和$qp_func是"函数处理器"，用户可以进行定制。缺省地，它
们被设为空串。对于$base64_func，一个空串意味着我们将使用PHP内置的base6
4_encode()函数...（是的！优美，不是吗！）。Quoted Printable可以通过$qp
_func被处理。在PHP中没有内置的quoted-printable 编码函数（然而，安装了i
map则可以使用imap_qprint()）。在这篇文章中我们将不再讨论quoted_printab
le方法。
<?php
//私有：
var $mimeparts = array();
?>
$mimeparts是一个内部数组，包含了邮件信息中各自独立的符合MIME段。请
不要在这个类（或派生类）之外操纵它和其它的私有方法/变量。
<?php
// 构造函数
function MIME_mail($from="", $to="", $subject="", $body="", $headers
= "") {
$this->to = $to;
$this->from = $from;
$this->subject = $subject;
$this->body = $body;
if (is_array($headers)) {
if (sizeof($headers)>1)
$headers=join(CRLF, $headers);
else
$headers=$headers[0];
}
if ($from) {
$headers = preg_replace("!(from:\ ?.+?[\r\n]?\b)!i", '', $head
ers);
}
$this->headers = chop($headers);
$this->mimeparts[] = "" ; //增加位置0
return;
}
?>
我们拥有对象的构造函数，它使用"from"和"to"邮件地址，主题和邮件体和
头作为参数。对于邮件体部分，可以给出你将可能输入的正常邮件。最后一个参
数是可选的（用户自定义）头。例如，X-Mailer: MyMailer_1.0。请注意$heade
rs可以是一个数组，包含了将要发给邮件发送程序的不同的头，或者只是某个特
别头的容器。你不能在$headers参数中发送From: 头，如果它被找到，这部分将
自动被去掉。你可以象下面使用多个头：array("X-Mailer: MYMailer_1.0", "X
-Organization: PHPBuilder.com")。
$mimeparts用一个空项（索引0）创建，在后面我们将看到这样用的道理。
核心：方法
我们将MIME信息头的生成，MIME段头的生成和最终的邮件消息的生成分成几
个模块。方法的实现是直接从我们前面遇到的MIME基础而来的。
<?php
function attach($data, $description = "", $contenttype = OCTET, $encod
ing = 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("!;cha
rset=!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);
}
?>
让我们仔细地看一下这个方法（对于其它的大部分方法也将如此）：
1.这个方法使用的参数有：
所附的实际数据（$data）
与Content-Description头相应的数据描述（$description）
将用在Content-Type头中的数据content-type值（$contentype）
用在Content-Transfer-Encoding中的编码值（$encoding）
用在Content-Disposition头$disp中的布局值，可以是INLINE或ATTACH，两
个都是常量
2.如BASE64，TEXT这样的值等等，作为常量被定义在附加的.def文件中。
3.使用$encoding值来决定需要用哪种编码方式对数据进行编码。有效的值是BIT
7(或7bit)，QP或BASE64。这个函数同时也检查了是否用户要使用他/她自已的BA
SE64或QP函数。在写这篇文章时，在我们的类中只有BIT7和BASE64被实现了，然
而，你可以传递你自已的quoted-printable 函数来使用，通过在前面讨论的$qp
_func类变量。
4.在编码处理之后，你会注意到对编码的信息使用了chunk_split()。这个函数根
据可选长度将字符串分割成小段。因为我们没有指出长度，缺省长度使用76。这
个非常附合邮件处理的习惯。
5.接着，如果$contenttype参数包含text/plain，则必须给出"charset=" 参数的
值。它的缺省值被定义在常量CHARSET中，值为us-ascii。注意当头使用参数值传
递时，在头与参数之间必须有一个分号（;）。
例如，Content-Type: text/plain; charset=us-ascii
6.如果其它MIME段头各自的值被传递给这个方法，这些段头被创建。毕竟我们不
想拥有一个没有描述的Content-Description头。在创建这些头之后，我们追加上
经过编码的数据部分信息。（检查一下方法中的sprintf()语句）。
同样，注意我们使用了一个叫BODY（又是一个常量）的特别描述字段。这就是我
们用在类实现中的东西。如果描述字段与BODY一样，我们将其赋给$mimeheaders
数组中的第一个元素。对于这个请多读几遍。
7.attach() 返回$mimeparts数组的当前大小，用在调用脚本的引用中。通过这种
方法就可以知道一个附件"X"存在哪一个索引中（实际返回的值要比在数组中的索
引小1）
8.注意所有的头必须用一个CRLF（\r\n）序列结束。
接着，我们看一下fattach()方法，fattach()与attach()相似，但是它使用
一个文件名作为它的第一个参数（作为attach()中$data的替换）。这个方法只是
一个封装，以便调用者可以用一个文件来调用fattach。fattach()然后将文件读
出，接着调用attach()来追加数据。这个方法在失败时返回0，可以在$errstr 变
量中找到解释或者当成功时，返回文件附件在$mimeparts数组中的索引号。
我们现在已经开发了附加数据的功能，对它们进行编码并且将单独的MIME段
放在私有数组中。还需要完成的工作是：
*.完成MIME的各个段
*.创建包含MIME信息头的邮件信息头，邮件原始的信息头（如To:, From:等等）
并且包括任何用户定义的头。在头后面追加完整的MIME段，这样一个完整的邮件
包就生成了。
我们将考查的下一个方法是，build_message()，它占据了整个工作的大部分
，但它是通过一个gen_email()的方法来调用的。请注意build_message()是一个
私有方法。
<?php
function build_message() {
$msg = "";
$boundary = 'PM'.chr(rand(65, 91)).'------'.md5(uniqid(rand()));
# 边界标识
$nparts = sizeof($this->mimeparts);
//情况1：存在附件列表，所以MIME信息头必须是multipart/mixed
if (is_array($this->mimeparts) && ($nparts > 1)) {
$c_ver = "MIME-Version: 1.0".CRLF;
$c_type = 'Content-Type: multipart/mixed;'.CRLF."\tboundary=\"
$boundary\"".CRLF;
$c_enc = "Content-Transfer-Encoding: ".BIT7.CRLF;
$c_desc = $c_desc?"Content-Description: $c_desc".CRLF:"";
$warning = CRLF.WARNING.CRLF.CRLF ;
// 如果存在MIMIE段，则邮件体也要变成附件
if (!empty($this->body)) {
$this->attach($this->body, BODY, TEXT, BIT7);
}
// 现在创建邮件的各个MIME段
for ($i=0 ; $i < $nparts; $i++) {
if (!empty($this->mimeparts[$i]))
$msg .= CRLF.'--'.$boundary.CRLF.$this->mimeparts[$i].
CRLF;
}
$msg .= '--'.$boundary.'--'.CRLF;
$msg = $c_ver.$c_type.$c_enc.$c_desc.$warning.$msg;
} else {
if (!empty($this->body)) $msg .= $this->body.CRLF.CRLF;
}
return $msg;
}
?>
这个方法有点自相予盾，简单而又复杂。要看你自已怎么看了。
1.我们在前面读到（在MIME基础中），每一个MIME段都有一个边界标记，这个标
记有一个唯一的id。边界标记被用在：
MIME信息头中，用来指示附件必须从哪进行划分
MIME段中；实际用在每一段的前面和后面来划分附件的边界。（回想一下Al
exander的有着图片和图谱的邮件！）（记住：最后一个边界标记要以两个连接符
（--）结束，用于指示范围结束）。 $boundary包含了边界标记，并且它是通过
一个随机数进行了唯一化再做MD5哈希生成的。另外，我们给$boundary冠以一个
"PM?"的前缀，这里"?"是一个随机字母。举一个$boundary的例子就是
"PMK------2345ee5de0052eba4daf47287953d37e"（PM表示PHP MIME，所以你可以
将其改为你的可能的初始值！）
2.在生成MIME头的处理中我们必须考虑两种情况。这些情况影响了邮件的原始邮
件体（$body在构造函数中）以哪种方式被看待和MIME信息头的特别表示。情况1
就是写这篇文章的原因，并且你会看到：可以有许多的附件被包含！在这种情况
下，请注意作为信息的部分被放上了警告字符串"This is a MIME encoding mes
sage"。因此，真正的消息体本身也必须以附件形式加到信息中！邮件的文本通常
是附件列表中的第一个附件，在我们的例子中就是$mimeparts。这个正好就是为
什么我们要占用一个$mimeparts索引的原因，以便让第一个索引（是0）可以用于
邮件文本部分。邮件体必须以7bit编码进行附加。
<?php
if (!empty($this->body)) {
$this->attach($this->body, BODY, TEXT, BIT7);
}
?>
上面的一小段代码完成附加邮件文本部分作为一个MIME附件的工作。注意，
我们使用了'BODY'常量来指示attach()要将附件加到何处。
第二种情况就是当不存在附件时，在这种情况下，如果提供了邮件文本，它
将是包含在局部变量$msg中的唯一信息；在这种情况下不需要MIME头。（然而，
在这种情况下我们还应该只把MIME-Version头指定出来----回过头到再看一下前
面的演示的最简单的MIME信息。）
3.MIME信息头（MIME-Version，Content-Type, 等等。）在有附件的时候被创建
。为了用MIME消息头来创建消息体，首先MIME信息头要被创建。然后各个有效的
MIME段通过$mimeheaders数组被反复处理。这就是边界标识被实际使用的地点。
根据规则的一致性，对一个MIME段被前缀上两个连接符（'--'.$BOUNDARY.crlf）
并且在最后一个MIME段的后面，在边界标识后追加两个连接符表示邮件范围结束
。
4.在变量$msg中的完整的信息作为这个方法的值被返回。
下一个方法，get_email()通过build_message()方法完成MIME消息的生成。
因为build_message()是一个内部方法，get_email()在调用完build_message()之
后，创建RFC 822的信息头并且追加上MIME信息。
<?php
function gen_email($force=false) {
if (!empty($this->email) && !$force) return $this->email ; // saves p
rocessing
$email = "";
if (empty($this->subject)) $this->subject = NOSUBJECT;
if (!empty($this->from)) $email .= 'From: '.$this->from.CRLF;
if (!empty($this->headers)) $email .= $this->headers.CRLF;
$email .= $this->build_message();
$this->email = $email;
return $this->email;
}
?>
对于我们的类的一个实例来说，类的成员$email拥有生成的整个邮件信息。
为了避免信息被无必要的重新生成，这个方法继续创建邮件头，并且只有当$mai
l为空时才调用build_message()。然而，你可以通过调用gen_email()来强制重新
处理。（如果"To"信息被改变或加入了一个新的附件，调用者显示想这么做）。
gen_email()创建了更熟悉的From头。另外，如果没有指定主题，它将主题设
为缺省值（No Subject）。我们直到后面才将To和Subject 的内含保存起来。这
个方法返回完整的邮件信息，这样就结束了创建MIME信息的任务。
值得说明的其它两个方法是print_mail()和send_mail()，两个都使用了$fo
rce参数。print_mail()输
出整个邮件信息，send_mail()使用PHP的mail()函数发送信息。可选的，send_m
ail()使用了一个SMTP对象
和它的发送方法（由用户指定）来发送邮件。
结论
创建一个符合MIME的信息不象看上去那么复杂，可以通过一个相当简单的方
式来实现。MIME消息可以给许多的站点带来新气象。
我们在上面开发的类覆盖了核心思想，并且它可以被扩展，唯一的限制是你
的想象力。例如，某人可以写出detach()函数，来删除指定索引的附件（attach
()方法可以返回这个信息）。
这个MIME_mail类可以用于发送基于HTML的邮件，不需要改造，只是嵌入的图
像不能被发送；这是一个需要特别注意的主题。
然而，没有图象的HTML或引用的图像使用了绝对URL或<BASE>标记也可以使用
MIME_mail类进行发送。一个例子如下：
<?php
$html_data = '<htm1><body text="#OOOOdd" bgcolor="#000000"><hl>Hello<
/hl><body></html>';
$mime = new MIME_mail($to, $from, $subject);
$mime->attach($html_data, "", OCTET, BASE64, INLINE);
$mime->send_mail ();
?>
这个邮件的收信人将得到一个黑色背景和蓝色的"Hello"文本的邮件！
发送完整的行内HTML信息，连同其它一些符合MIME邮件发送的高级专题，值
得特别考虑，希望这些将成为这篇文章的继续。
注：MIME_mail类，常量文件和运行实例可以在此[http://phprecord.e-chome.n
et/docs/kartic20000807.zip]下载zip压缩包。
---------------------------------------------------------------------
来自:http://phprecord.126.com
原文:http://www.phpbuilder.com
作者:Kartic Krishnamurthy
译者:limodou
--
※ 来源:．月光软件站 http://www.moon-soft.com．[FROM: 61.141.205.77]
|
|