PHPMailer介紹與使用

PHPMailer介紹與使用

介紹

再撰寫PHP網站時,發送e-mail是一個經常使用的功能,PHP本身就有提供寄送e-amil的功能可以使用,就是利用mail( )這個函式,有關mail( )如何使用可參考:http://tw2.php.net/mail。

但是PHP內建的mail( )功能並不完善,以我所碰到的經驗為例,最基本的就是只能寄送文字e-mail,但時至今日,很多e-mail大多以HTML格式為主,除了能夠插入圖之外,e-mail的文字顯示也具有較豐富的變化。

而在PHP中,有一個相當好用且為開放原始碼的寄送e-mail模組-PHPMailer,這個模組的功能較為完整,其功能包括:

* 寄送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信件了,是不是相當簡單呢?

分類: 未分類

發表迴響