CodeIgniter框架下Gmail收信触发Web应用通知的实现方案咨询

1. 解决IMAP精确时间筛选/UID检索问题 #

你之前的使用方式有偏差，IMAP本身支持精确到秒的时间筛选，也支持UID检索，只是Gmail的IMAP实现和原生标准有微小差异，你之前调用的是仅传日期的SINCE参数，没有用到完整时间参数而已。

• 精确时间筛选实现：
  把需要的起始时间转换为IMAP内部日期格式，用SEARCH命令的SINCE参数传入完整时间即可。比如要获取2021-10-11 15:00之后的邮件，命令格式为SEARCH SINCE "11-Oct-2021 15:00:00 +0800"，注意替换为你所在地区的对应时区。CodeIgniter可以直接调用PHP原生imap扩展实现，写法示例：

  $startDate = "11-Oct-2021 15:00:00 +0800";
  $mailResult = imap_search($imapConnect, 'SINCE "'.$startDate.'"');
  

  如果返回结果不符合预期，可以把时间转换为UTC时区后再传入参数。
• UID检索实现：
  这种方式比时间筛选更准确，不会因为时区、邮件头日期异常出现漏收/重复收取的问题。你可以每次拉取邮件后在本地缓存/数据库记录最新的邮件UID，下次检索直接查询大于该UID的所有邮件即可，CodeIgniter内调用示例：

  // $lastSavedUid 为你本地存储的上次拉取的最大UID
  $newMails = imap_fetch_overview($imapConnect, ($lastSavedUid + 1).":*", FT_UID);
  

  每次拉取完成后更新本地存储的lastSavedUid为本次拉取到的最大UID即可，检索效率远高于时间筛选。

2. 新邮件自动触发Webhook方案 #

如果不想轮询IMAP，可以直接用Gmail官方的推送通知功能，Gmail收到新邮件时会主动调用你指定的Webhook地址，不需要你主动轮询。
实现逻辑：

• 开通Google Cloud账号创建项目，启用Gmail API
• 配置Cloud Pub/Sub主题，给Gmail官方服务账号授予该主题的发布权限
• 调用Gmail API的users.watch方法，绑定你的Gmail账号和Pub/Sub主题，指定监听新邮件到达事件
• 在Pub/Sub中配置推送订阅，目标地址填你CodeIgniter应用提供的Webhook接口地址
• 在CodeIgniter中编写对应的POST接口，接收Pub/Sub推送的事件通知，收到通知后再拉取对应新邮件的内容，更新应用内的通知即可
  该方案比轮询IMAP及时性更高，服务端资源消耗也更低。

3. CodeIgniter适配建议 #

• 如果你选IMAP轮询方案：可以搭配CodeIgniter的任务调度功能，或者用系统crontab，每隔1-5分钟执行一次IMAP拉取任务，对比UID后更新通知即可，适合小流量场景，开发成本很低
• 如果你选Webhook方案：直接在CodeIgniter中写POST接口处理推送即可，注意要校验请求签名，避免恶意请求伪造通知

内容的提问来源于stack exchange，提问作者Demo logixbuilt