PHP调用imap_open连接Gmail失败，无低安全应用设置解决方案

问题情况 #

使用以下PHP代码尝试连接Gmail收件箱：

$hostname = '{imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX';
$inbox = imap_open($hostname, $username, $password) or die('Cannot connect to Gmail: ' . imap_last_error());

出现报错：

imap_open(): Couldn't open stream {imap.gmail.com:993/imap/ssl/novalidate-cert}INBOX

且Gmail已移除“低安全应用”选项，无法通过该方式解决连接问题。

可行解决方案 #

1. 启用两步验证后使用应用专用密码 #

这是最快捷的解决方式：

• 先给你的Google账号开启两步验证
• 登录Google账号的安全设置页面，在「登录Google」板块找到「应用专用密码」
• 生成一个应用专用密码：选择应用类型为「邮件」，设备选「其他」（自定义名称比如「PHP IMAP」）
• 将代码中的$password替换为这个生成的应用专用密码，原代码逻辑无需改动

2. 采用OAuth2认证（适合生产环境，更安全） #

如果需要更高安全性，推荐用OAuth2协议：

• 在Google Cloud Console创建项目，启用Gmail API
• 创建OAuth客户端ID，配置授权回调地址（本地测试可填http://localhost）
• 使用PHP的OAuth2库（比如league/oauth2-google）获取访问令牌和刷新令牌
• 修改IMAP连接字符串，添加auth=XOAUTH2参数，用令牌替代密码：

$hostname = '{imap.gmail.com:993/imap/ssl/auth=XOAUTH2}INBOX';
$oauth_token = '获取到的访问令牌';
$inbox = imap_open($hostname, $username, $oauth_token) or die('Cannot connect to Gmail: ' . imap_last_error());

额外排查点 #

• 确认PHP环境已安装并启用imap扩展（通过phpinfo()查看相关配置）
• 检查服务器防火墙是否允许出站访问993端口
• 确保Gmail账号已开启IMAP服务：进入Gmail设置→转发和POP/IMAP→启用IMAP访问

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