如何配置请求头使Gmail可识别PHP IMAP客户端身份

Gmail对IMAP客户端的识别不依赖HTTP请求头，而是基于RFC 2971定义的IMAP ID扩展协议，通过客户端建立连接后主动发送的ID命令携带的客户端元信息完成识别。PHP原生imap扩展默认不会主动发送该命令，因此会被Gmail判定为未知客户端。

实现要求 #

• PHP环境的imap扩展需支持IMAP ID扩展（PHP 5.3及以上版本的官方编译版本均已支持，可通过phpinfo()的imap模块页确认支持项）
• 已开启Gmail账号的IMAP访问权限，且使用合法的账号凭证（建议使用Gmail应用密码避免登录拦截）

实现代码 #

在成功建立IMAP连接后，主动发送ID命令携带自定义客户端信息即可：

// 建立Gmail IMAP连接
$imapConnection = imap_open('{imap.gmail.com:993/imap/ssl}INBOX', '你的Gmail邮箱地址', '你的Gmail访问凭证');
if (!$imapConnection) {
    die('连接失败：' . imap_last_error());
}

// 发送IMAP ID命令上报客户端信息，字段可根据实际需求自定义
$sendIdCmd = 'ID ("name" "自定义客户端名称" "version" "1.0.0" "vendor" "开发者/团队名称")';
$idResponse = imap_fetch_connection($imapConnection, $sendIdCmd);

// 后续正常执行邮件读取、管理等操作
// ...

// 关闭IMAP连接
imap_close($imapConnection);

配置说明 #

• ID命令中的name字段为客户端核心识别字段，Gmail活动详情页将直接展示该字段的内容
• 其余字段如version（客户端版本）、vendor（开发主体）为选填，可按需增减
• 若使用第三方PHP IMAP封装库，通常已封装好客户端信息上报方法，直接调用对应方法传入参数即可，无需手动拼接原生命令

验证方法 #

重新运行客户端访问Gmail后，打开Gmail网页版右下角的「详情」入口，在IMAP访问活动列表中即可看到你自定义的客户端名称。

内容的提问来源于stack exchange，提问作者Tariq Sajid