如何使用OAuth认证IMAP并保留PHP原生IMAP函数的使用？

核心思路 #

通过微软Azure AD获取OAuth2访问令牌，利用PHP IMAP扩展的OAUTH2认证支持替换原基础认证的imap_open调用，返回的资源可直接用于你现有所有原生IMAP函数，无需修改业务代码。

步骤1：获取微软OAuth2访问令牌 #

前置准备 #

• 在Azure AD注册应用，配置Office 365 Exchange Online的IMAP.AccessAsApp应用权限，并完成管理员同意。
• 记录应用的tenant-id、client-id、client-secret。

令牌获取代码（PHP5.3兼容，用curl实现） #

$tenantId = '你的租户ID';
$clientId = '你的客户端ID';
$clientSecret = '你的客户端密钥';
$scope = 'https%3A%2F%2Foutlook.office365.com%2FIMAP.AccessAsApp';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://login.microsoftonline.com/{$tenantId}/oauth2/v2.0/token");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'client_id' => $clientId,
    'client_secret' => $clientSecret,
    'scope' => $scope,
    'grant_type' => 'client_credentials'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // PHP5.3证书库可能不全，按需开启

$response = curl_exec($ch);
curl_close($ch);

$tokenData = json_decode($response, true);
$accessToken = $tokenData['access_token'];

步骤2：用OAuth2令牌调用imap_open #

替换原基础认证的imap_open调用，使用以下格式：

// 邮箱路径指定oauth2认证
$imapPath = '{outlook.office365.com:993/imap/ssl/auth=oauth2}INBOX';
$userEmail = '要连接的邮箱地址';
$imapResource = imap_open($imapPath, $userEmail, $accessToken);

// 后续直接使用该资源调用所有原生IMAP函数，无需修改
// 示例：获取邮件内容
$body = imap_fetchbody($imapResource, 1, 1);
// 其他函数如imap_delete、imap_expunge等均可正常使用

关键注意事项 #

• IMAP扩展版本要求：确保PHP5.3的IMAP扩展基于c-client 2007e及以上版本，否则不支持OAUTH2认证，需更新IMAP扩展。
• 令牌刷新：访问令牌默认有效期1小时，需实现定时刷新逻辑，避免连接失效。
• 权限配置：Azure AD应用必须完成管理员同意，否则无法获取有效令牌。

内容的提问来源于stack exchange，提问作者Andre Felipe Vieira