介紹
再撰寫PHP網站時，發送e-mail是一個經常使用的功能，PHP本身就有提供寄送e-amil的功能可以使用，就是利用mail( )這個函式，有關mail( )如何使用可參考：http://tw2.php.net/mail。
但是PHP內建的mail( )功能並不完善，以我所碰到的經驗為例，最基本的就是只能寄送文字e-mail，但時至今日，很多e-mail大多以HTML格式為主，除了能夠插入圖之外，e-mail的文字顯示也具有較豐富的變化。
* 寄送e-mail時指定多個收件人，寄送副本與密件副本
* 支援多種e-mail郵件編碼包括：
o 8bit
o base64
o binary
o quoted-printable
* 支援SMTP驗證
* 支援備援SMTP伺服器
* e-mail可夾帶附檔
* 支援HTML格式的e-mail
* 自定義e-mail表頭(Header)
* 可在郵件中放置圖片
* 相容的SMTP伺服器包括：
o Sendmail
o Qmail
o Postfix
o Imail
o Exchange
* 跨平台
本篇技術文章就針對這個模組做一個介紹以及如何使用。
需求
需要PHP 5以上
下載與安裝
PHPMailer的官方網站為：http://phpmailer.codeworxtech.com/
使用者可直接在這邊下載，PHPMailer模組可直接在sourceforge.net這個有名的網站下載使用。目前針對PHP 5的最新版本為PHPMailer v2.2.1。
下載並解壓縮之後，裡面最主要提供e-mail功能的是下列這3個PHP檔：
* class.phpmailer.php
* class.pop3.php
* class.smtp.php
而下載的檔案中也包含了這個模組的文件以及使用範例，所以使用上來說也相當簡單。
未避免麻煩，建議把這3個檔案都放置在一起。
如何使用
首先，當然要把class.phpmailer.php include進來使用：
接著要實體化一個PHPMailer物件，所有要寄送的e-mail接由這物件進行處理：
假設你要寄送的e-mail的內容為body.html，則可利用getFile( )把內容加入進來，通常由於THML是以”\”做為換行符號，所以可再做一些加工處理，這邊是將”\”皆以空白字元來代替：
getFile('contents.html');
$body = eregi_replace("[\]",'',$body);
?>
至此已經將所要寄送的e-mail內容準備完畢。
PHPMailer預設寄送e-mail的是使用PHP內建的mail( )，若要使用其他方式，例如要使用SMTP…等，則必須要再進行額外的設定。以我為例，由於我利用本身這台伺服器。經由SMTP來發送信件(所以我有我自 己的寄件者e-mail格式)，所以還需要進行下列設定：
IsSMTP( );
//使用SMTP寄送信件
$mail->Host = "localhost";
//指定發送信件的伺服器
$mail->SMTPAuth = false;
//是否使用SMTP驗證
$mail->Port = 25;
//設定使用的SMTP port
?>
另外，如果你要指定PHPMailer使用其他方式來寄送e-mail，例如SendMail，如下所示：
IsSendmail();
//指定PHPMailer使用SendMail來寄送e-mail
?>
接著我要對這封信的主旨、寄件者或收件者進行設定。
From = " www-data@support.oss.org.tw";
//指定寄件者的email位址
$mail->FromName = "自由軟體組";
//寄件者的名稱sender's name
$mail->Subject = "這是主旨";
//email的主旨
$mail->AltBody = $altbody;
//這個設定主要是預防收件者無法顯示HTML信件時的替代文字
$mail->WordWrap = 50;
//設定一行最多為50個字元，即每50個字自動斷行
?>
如一開始所說，PHPMailer可以指定e-mail的編碼：
CharSet="utf-8";
//設定e-mail編碼
$mail->Encoding = "base64";
//設定信件編碼，大部分郵件工具都支援此編碼方式
?>
再來就是把剛剛的信件內容加入到信件中：
MsgHTML($body);
//信件內容
$mail->AddReplyTo(" info@iii.org.tw", "Info");
//設定回函
?>
至此已經完成信件內容與寄件者的設定，再來就是設定信件寄送給誰：
AddAddress(" xxx@iii.org.tw");
//指定收件者的email位址
$mail->AddAddress(" yyy@iii.org.tw", "yyy");
//指定收件者的email位址，並且設定收件者名稱
$mail->AddBCC(" zzz@iii.org.tw", "zzz");
//使用密件副本
$mail->AddAttachment("/var/tmp/file.tar.gz");
//新增附件檔案
$mail->AddAttachment("/tmp/image.jpg", "new.jpg");
//附件也可以更改名稱
?>
到這邊已經完成大部分設定動作，在最後設定將信件以HTML格式寄出：
IsHTML(true); //設定信件內容為HTML
?>
使用PHPMailer寄送gmail信件
有相當多人使用Gmail，而PHPMailer也可以寄送gmail信件，在設定上其實與上述並無太大的差別，以下列出需額外設定的部分：
getFile('contents.html');
$body = eregi_replace("[\]",'',$body);
$mail->IsSMTP();
$mail->SMTPAuth = true;
//需使用SMTP驗證
$mail->SMTPSecure = "ssl";
// 利用SSL連線到伺服器
$mail->Host = "smtp.gmail.com";
//當然啦，信件寄送主機就是GMAIL
$mail->Port = 465;
//指定SMTP port
$mail->Username = " yourname@gmail.com";
//GMAIL帳號
$mail->Password = "password";
// GMAIL密碼
//以下有關信件的部分與之前一章大同小異，故省略之。
?>
這樣就可以寄送Gmail信件了，是不是相當簡單呢？
沒有留言:
張貼留言