PHP 中 IMAP 扩展的简单入门
这是我参与8月更文挑战的第24天,活动详情查看:8月更文挑战
对于邮件处理来说,大家比较熟悉的应该是 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-/xxxxxx@139.com"
// }
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邮箱团队 <10000@qq.com>"
// ["To"]=>
// string(29) "xxx <xxxxxxx@qq.com>"
// ["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 class="email_container">
// <div class="head" style="background: #f3f3f3;">
// <span class="content" 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 的知识我们就简单地入门学习一下,因为在学习这块内容的时候我发现网上已经有很多大神门封装好的类可以让我们直接复制下来使用。另外,它的功能非常丰富,还有很多函数并没有介绍,比如说操作附件之类的功能,相信大家在自己的学习和使用过程中都会慢慢接触到的。
测试代码:
github.com/zhangyue050…
参考文档:
www.php.net/manual/zh/b…
推荐阅读
-
什么是 PHP 中的日历扩展?如何使用?
-
aps是什么意思_不同的富士APS-C画幅微单区别在哪里,档次是怎么划分的?-X-A系列原本指的是富士的入门级微单,最大的特点是没有使用富士X-Trans™CMOS 传感器,目前在售的有两款,分别是XA5和XA7。 富士(FUJIFILM)X-A5/XA5 15-45套机 富士(FUJIFILM)X-A7/XA7 15-45套机 目前这两款相机都处于历史最低价附近,XA5套机2699元,XA7套机3999元。XA5就是一个标准的入门级相机,定位就是时尚小巧自拍,在2699这个价位不要对它的性能有太多的奢求。 XA7价格来到了3999元,这就很有意思了,富士把入门型的相机价格推到了4000元,并且提供了自拍翻转屏和4K30P视频录制,这样一款相机就很有性价比了。 XE3是老款的中端相机,价格和入门级的XA7是一样的,都是3999元,这两款相机如何做选择呢?XE3有着更多的按键意味着更好的操控,但屏幕不是自拍翻转屏所以这点不如XA7好用。 要注意的是XE3用的是富士独有的X-Trans™CMOS III传感器,XA7是普通的2400万像素传感器,你可以理解为X-Trans才是富士的精髓。 富士(FUJIFILM)X-E3 15-45套机 当然,买新不买旧,XA7的新功能和自拍翻转屏可能会更适合你。 XT200是富士专门针对vlog市场推出的相机,其实之前的XA7也可以拍摄vlog,但XT200是富士官方宣传中的第一款vlog相机。数码防抖+3.5mm 麦克风口+自拍翻转屏+无裁切4K30P,这些都是XT200的优势,但这款相机也是普通的2400万像素传感器,没有用富士独有的X-Trans,可能是从价格角度考虑做了阉割吧。 富士(FUJIFILM)X-T200/XT200 微单相机 Vlog相机 富士XT30是我认为富士性价比最高的微单照相机,注意我说的是照相机。理由很简单,因为从拍照角度来看XT30和XTXT3几乎没有明显差距,主要是操控差了一些、视频性能大幅削弱,但好歹也是个有着双波轮+曝光补偿波轮+快门速度波轮的相机,操控方面不会太差的。视频方面也有着超采4K 30P的规格,支持F-log输出。 可以这么说,如果你只拍照,那么XT30是富士微单中性价比最高的,视频方面XT30也不差,只不过没有专业的10bit和4K60P而已。 富士(FUJIFILM)X-T30/XT30 15-45套机 XT3和XT4得放在一起说,这两款相机其实都挺好,420 10bit 4K60P的专业视频模式基本代表了APS-C画幅的上限水平。XT4还提升了电池续航增加了五轴防抖,配上富士独特的胶片滤镜,不管是拍照还是拍视频都非常优秀。 不要觉得这两款相机贵,同价位里能做到4K60P的微单也就是M43画幅的GGHGH5S,最便宜的G9机身也要7000多,这APS-C画幅的XT3机身接近8000也算合理价格范围内。除此之外的4K60P机身只有13998的松下S5和15999的佳能R6了。 富士(FUJIFILM)X-T3/XT3 1855套机 富士(FUJIFILM)X-T4/XT4 微单相机 套机(18-55mm) B站更新4K视频投稿后有很多人想拍摄4K升格,在很长一段时间里富士XT3和XT4是最优选,毕竟兼顾视频和拍照,对焦也还算能用。 X-Pro3和X-Pro2这两款微单可以算是旁轴相机,是富士官方意义上的旗舰级相机。从用料做工操控按键角度来说的确是旗舰级别,但视频性能方面只有4K30P,价格却比XT3还贵,可能这就是旁轴情怀带来的溢价吧。 富士(FUJIFILM)X-Pro3 微单相机 机身 黑色 我在之前的文章里提过很多次,有一些相机属于如果你想买你压根不会看测评,如果你犹豫那么这款相机不适合你,为什么这么说,因为有一些比较小众的相机可能在性能上并不好,但独特的外形、操控、体积、传承赋予了它独特的定位。譬如富士X-Pro系列微单就是旁轴的电子化,理光GR传承大师的扫街理念,尼康DF的外形源自胶片时代的相机,这些相机就不是针对大多数消费者的,定位就是小众。所以我说喜欢就买,不要考虑什么性能规格。 X100系列相机是一款不可换镜头的等效35mm旁轴数码相机,从外形看就是经典的复古造型。这两款相机和X-Pro3一样,如果你喜欢那就买,别犹豫, 你在市场上找不到同类型的其他数码相机,徕卡Q是28mm,索尼RX1R系列是35mm但外形不够复古,X100系列就是独特的你没有其他选择。 那么X100F和X100V该如何选择呢?X100F的镜头很一般甚至算不上好,如果我没记错的话和初代的X100是同款镜头,X100V的镜头是全新制作的很棒,X100V的机身性能也和XTX-Pro3差不多。 富士(FUJIFILM)X100F 数码相机 旁轴 2430万像素 富士(FUJIFILM)X100V 数码相机 旁轴 2610万像素 还是那句话,这两款相机也是那种如果你喜欢那就毫不犹豫下单的类型,而且这两款相机也没有竞品。 以前不推荐富士的原因是原厂镜头太贵,现在唯卓仕给富士出了四款可以自动对焦的大光圈镜头,覆盖35到130mm的焦段,可以基本满足人像摄影爱好者的需求。拍风景的话国产很多镜头厂商都有富士卡口的手动镜头可以选择,从这个角度来说富士微单就非常值得入手了。 和友商竞品相比:
-
19.MySQL 中的空间扩展 - [ MySQL 5.1 参考手册 ] - 本地在线手册 - php中文网-! 19.2.1.几何类层次结构
-
介绍新手入门级入侵检测技术的构建及其在简单场景中的应用
-
PHP 中 IMAP 扩展的简单入门
-
简单使用 php 中的收益生成器 - 摘要
-
简单易懂!Unity中Entitas框架的入门指南
-
南邮OJ Web任务大揭秘:层层挑战剖析 1. 挑战一:迷宫般的目录探索 题目作者似乎穷举了所有可能的目录组合,最终在404.php中的