對于郵件處理來說,大家比較熟悉的應該是 POP3 、 SMTP 這類的協議,而今天我們介紹的 IMAP 其實也是非常常用的一種郵件處理協議,它和 POP3 比較類似,都是以接收處理郵件為主,不過相對于 POP3 來說,IMAP 在本地的操作都會直接同步到線上的郵件服務器, POP3 一般不會直接地進行同步,這就是它們兩個最大的區別,關于這些郵件協議的具體內容,如果還有不太了解的同學,可以多在網上查閱相關的資料,
不管是 IMAP 還是 POP3 ,與 SMTP 配合后都能非常簡單地實作一個郵件客戶端的功能,這篇文章我們就主要來學習一下 PHP 中的 IMAP 擴展的一些簡單內容,
安裝擴展
首先,就是安裝 IMAP 的擴展,這個擴展是隨 PHP 原始碼包一起發布的,在編譯的時候可以直接給 configure 添加 --with-imap 以及 --with-imap-ssl 就可以了,如果是后期安裝的話,直接在原始碼包的 ext 目錄下找到 imap 目錄就可以進去進行普通的擴展安裝步驟了,
不過需要注意的是,IMAP 擴展是需要作業系統環境中也安裝一些組件的,
yum install -y libc-client-devel libc-client
ln -s /usr/lib64/libc-client.so /usr/lib/libc-client.a
ln -s /usr/lib64/libkrb5.so /usr/lib/libkrb5.so
我們需要安裝 libc-client-devel ,然后建立兩個軟連接,否則在擴展編碼安裝的時候可能出現問題,
連接 QQ 郵箱
接下來,我們嘗試連接一下 QQ 郵箱,
$host = "{imap.qq.com:993/imap2/ssl}INBOX";
$username = "xxxx"; // 不用帶 @qq.com
$password = "xxxxxx"; // 開通 imap 后獲得的授權登錄碼
$mbox = imap_open($host, $username, $password);
很簡單的函式,imap_open() 用于打開連接郵箱的句柄,三個引數也很直觀,host 指定郵箱的域名地址,并且可以直接指定連接到郵箱中的哪個檔案夾,在這里我們直接進入的是收件箱,連接 QQ 郵箱的時候用戶名直接使用 QQ 號就可以了,不需要在后面帶上 @qq.com ,而密碼則是我們在 QQ 郵箱的設定中,選擇帳號管理,開通 imap 功能后所獲得的授權登錄碼,
查看郵箱資訊
連接郵箱成功后,就可以查看相關的一些資訊,
$rowsCount = imap_num_msg($mbox);
echo $rowsCount, PHP_EOL;
// 37
imap_num_msg() 回傳的是郵箱中的訊息數量,其實也就是我們的郵件數量,
$list = imap_list($mbox, "{imap.qq.com}", "*");
var_dump($list);
// array(6) {
// [0]=>
// string(18) "{imap.qq.com}INBOX"
// [1]=>
// string(26) "{imap.qq.com}Sent Messages"
// [2]=>
// string(19) "{imap.qq.com}Drafts"
// [3]=>
// string(29) "{imap.qq.com}Deleted Messages"
// [4]=>
// string(17) "{imap.qq.com}Junk"
// [5]=>
// string(51) "{imap.qq.com}&UXZO1mWHTvZZOQ-/[email protected]"
// }
imap_list() 函式回傳的是郵箱中的檔案夾資訊,比如我們這里有 INBOX 收件箱、Sent Messages 已發送郵件、Drafts 草稿箱、Deleted Messages 已洗掉郵件、Junk 垃圾箱,另外還有一個是我的郵箱中系結的 139 的郵箱檔案夾也顯示了出來,
$chk = (array) imap_mailboxmsginfo($mbox);
var_dump($chk);
// array(8) {
// ["Unread"]=>
// int(34)
// ["Deleted"]=>
// int(0)
// ["Nmsgs"]=>
// int(37)
// ["Size"]=>
// int(951128)
// ["Date"]=>
// string(37) "Wed, 16 Dec 2020 14:31:50 +0800 (CST)"
// ["Driver"]=>
// string(4) "imap"
// ["Mailbox"]=>
// string(54) "{imap.qq.com:993/imap/notls/ssl/user="149844827"}INBOX"
// ["Recent"]=>
// int(0)
// }
imap_mailboxmsginfo() 回傳的是當前郵箱檔案夾中的資訊,從回傳的欄位可以看出,我們有 Unread 未讀郵件 34 封,新郵件 37 封,大小、獲取時間、郵箱資訊等內容,
讀取操作郵件
最后就是我們的重頭戲了,如何下載讀取郵件以及進行一些簡單地操作,
$all = imap_search($mbox, "ALL");
var_dump($all);
// array(37) {
// [0]=>
// int(1)
// [1]=>
// int(2)
// [2]=>
// int(3)
// [3]=>
// int(4)
// [4]=>
// int(5)
// ……
// ……
foreach ($all as $m) {
$headers = imap_fetchheader($mbox, $m);
$rawBody = imap_fetchbody($mbox, $m, FT_UID);
$headers = iconv_mime_decode_headers($headers, 0, "UTF-8");
var_dump($headers);
if (isset($headers['Content-Transfer-Encoding']) && $headers['Content-Transfer-Encoding'] == 'base64') {
$rawBody = imap_base64($rawBody);
}
var_dump($rawBody);
if ($m == 1) {
imap_mail_copy($mbox, $m, "Drafts"); // 拷貝到草稿箱
imap_setflag_full($mbox, $m, "Seen"); // 設定為已讀
}
if ($m == 2) {
imap_delete($mbox, $m); // 洗掉
imap_expunge($mbox);
}
if ($m == 3) {
imap_mail_move($mbox, $m, "Junk"); // 移動
imap_expunge($mbox);
}
}
imap_search() 用于查找郵件,它的第二個引數是指定的字串,比如這個 ALL 就是回傳所有的郵件資訊,它還可以指定為 DELETED、UNSEEN 等許多內容,具體的引數串列大家可以查閱相關的檔案,這個函式獲取的是郵件資訊的所有的郵件編號,其實可以看出來,它就是從 1 到 37 的數字編號,
讀取郵件
imap_fetchheader() 和 imap_fetchbody() 分別就是根據郵件編號讀取郵件的頭資訊和內容資訊,如果正常列印的話,它們的內容都是經過編碼的,也就是說我們不能直觀地看到具體的內容資訊,所以需要對頭檔案進行一個 UTF-8 解碼的程序,郵件內容則根據頭資訊中的 Content-Transfer-Encoding 欄位查看對應的編碼型別進行解碼,這里我們只演示了 base64 編碼的情況,其實它還有別的編碼格式,有興趣的同學可以自己查閱資料深入了解一下,
// 第一封郵件
// headers
// array(13) {
// ["From"]=>
// string(29) "QQ郵箱團隊 <[email protected]>"
// ["To"]=>
// string(29) "xxx <[email protected]>"
// ["Subject"]=>
// string(53) "更安全、更高效、更強大,盡在QQ郵箱APP"
// ["Date"]=>
// string(31) "Wed, 16 Dec 2020 10:08:54 +0800"
// ["Message-ID"]=>
// string(38) "<app_popularize.1608084534.3423313103>"
// ["X-QQ-STYLE"]=>
// string(1) "1"
// ["X-QQ-SYSID"]=>
// string(9) "100000010"
// ["X-QQ-MIME"]=>
// string(21) "TCMime 1.0 by Tencent"
// ["X-QQ-Mailer"]=>
// string(10) "QQMail 2.x"
// ["X-QQ-mid"]=>
// string(30) "mmnez10417t1608084534tfekjqwx0"
// ["Content-Type"]=>
// string(26) "text/html; charset="utf-8""
// ["Content-Transfer-Encoding"]=>
// string(6) "base64"
// ["Mime-Version"]=>
// string(3) "1.0"
// }
上述內容就是第一封郵件的 header 資訊,從資訊內容中可以看到 Subject 就是郵件的標題,這是一封 QQ 郵箱系統發出的郵件,From 和 To 分別就是發件人和收件人的郵箱地址,其它比較重要的就是 Content-Type 和 Content-Transfer-Encoding 分別對應著檔案型別、字符集編碼和轉換編碼型別,
不同的郵件的郵件頭會不一樣,我們這里只是展示了最簡單的一種,
// rawBody
// string(5850) "
// <!DOCTYPE html>
// <html>
// <head>
// <meta charset="UTF-8">
// <title>imap</title>
// <style>
// @media screen and (min-width: 700px) {
// .bottomErweima {
// display: block !important;
// }
// #btn {
// display: none !important;
// }
// .footer {
// display: none !important;
// }
// }
// /* vivo手機width: 980px 同時 aspect-ratio小于1的,處于700px-1000px的手機*/
// @media screen and (min-width: 700px) and (max-width: 1000px) and (max-aspect-ratio:1/1){
// .bottomErweima {
// display: none !important;
// }
// #btn {
// display: block !important;
// }
// .footer {
// display: block !important;
// }
// }
// </style>
// </head>
// <body style="width: 100%;margin: 0;padding: 0;position: relative;">
// <div id="email-box" style="max-width: 550px;margin: 0 auto;">
// <div >
// <div style="background: #f3f3f3;">
// <span style="font-size: 14px;color: #000000;line-height: 26px;display: block;padding: 40px 20px;">QQ郵箱APP,讓高效觸手可及,在這里,你可以登錄多個郵箱賬號、便捷存盤微信郵件、多視窗編輯郵件......還有更多功能,等你探索!</span>
// </div>
// ……
// ……
郵件的內容在使用 imap_base64() 決議之后就是簡單地 HTML 格式的內容,這和頭資訊中的 Content-Type 是直接對應的,imap_base64() 其實和 base64_decode() 并沒有什么區別,大家直接使用 base64_decode() 也是沒有問題的,當然,前提是要判斷 Content-Transfer-Encoding 中是否使用了 base64 來對郵件內容進行了編碼,有的郵件中可能連這個欄位都沒有,
復制、移動、洗掉郵件
imap_mail_copy() 用于復制郵件,在這里,我們將第一封郵件復制到了草稿箱中,然后使用 imap_setflag_full() 將這封郵件標記為已讀,從引數就可以看出來 Seem 就是已讀的意思,當然它還有別的引數,比如 Deleted 、 Draft 之類的內容,
imap_delete() 函式用于洗掉郵件,imap_mail_move() 用于移動檔案,呼叫這兩個函式都需要使用 imap_expunge() 來將操作同步到線上,
進行完操作后,大家可以直接看一下線上的郵件是不是已經產生了相應的變化了,
總結
IMAP 的知識我們就簡單地入門學習一下,因為在學習這塊內容的時候我發現網上已經有很多大神門封裝好的類可以讓我們直接復制下來使用,另外,它的功能非常豐富,還有很多函式并沒有介紹,比如說操作附件之類的功能,相信大家在自己的學習和使用程序中都會慢慢接觸到的,
測驗代碼:
https://github.com/zhangyue0503/dev-blog/blob/master/php/202012/source/6.PHP中的IMAP擴展簡單入門.php
參考檔案:
https://www.php.net/manual/zh/book.imap.php
關注公眾號:【硬核專案經理】獲取最新文章
添加微信/QQ好友:【xiaoyuezigonggong/149844827】免費得PHP、專案管理學習資料
知乎、公眾號、抖音、頭條搜索【硬核專案經理】
B站ID:482780532
轉載請註明出處,本文鏈接:https://www.uj5u.com/houduan/296005.html
標籤:PHP
下一篇:學習PHP中的任意精度擴展函式
