核心:方法
我們將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數組中的索引號。