PHP imap_open连接Outlook从基础认证转现代认证的方案求助

前提准备：Azure AD应用注册与配置 #

Office365的现代认证依赖Azure AD的OAuth2协议，首先需在Azure门户完成应用注册：

• 登录Azure门户，进入Azure Active Directory → 应用注册 → 新建注册
• 填写应用名称，账户类型选择「任何组织目录中的账户和个人Microsoft账户」（仅企业内部使用选第一个即可）
• 重定向URI选「Web」，临时填http://localhost/oauth-callback（生产环境可后续修改）
• 注册完成后，记录客户端ID和租户ID
• 进入「证书和密码」→ 「客户端密码」→ 新建密码，设置有效期后保存生成的密码值（仅显示一次，务必存好）
• 进入「API权限」→ 「添加权限」→ 选「Microsoft Graph」→ 「应用权限」，搜索并勾选IMAP.AccessAsApp，然后点击「添加权限」，最后点击「授予管理员同意」（必须由Azure AD管理员操作）

PHP端实现：OAuth2令牌获取与IMAP连接 #

PHP原生imap_open不直接支持OAuth2，需先获取有效访问令牌，再通过特殊参数建立连接。以下提供两种实现方式：

方式1：原生PHP实现（依赖cURL扩展） #

1. 获取OAuth2访问令牌

$tenantId = "你的租户ID";
$clientId = "你的客户端ID";
$clientSecret = "你的客户端密码";
$scope = "https://outlook.office365.com/.default";

$tokenEndpoint = "https://login.microsoftonline.com/$tenantId/oauth2/v2.0/token";
$postData = http_build_query([
    'grant_type'    => 'client_credentials',
    'client_id'     => $clientId,
    'client_secret' => $clientSecret,
    'scope'         => $scope
]);

$ch = curl_init($tokenEndpoint);
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $postData,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/x-www-form-urlencoded']
]);

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

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

if (empty($accessToken)) {
    die("令牌获取失败：" . $response);
}

2. 使用令牌连接IMAP并读取邮件

$targetEmail = "你的Office365邮箱地址";
// 构造IMAP连接字符串，核心是oauth参数传入令牌
$imapHost = "{outlook.office365.com:993/imap/ssl/authuser=$targetEmail/user=$targetEmail/oauth=$accessToken}INBOX";

$imapStream = imap_open($imapHost, '', '');
if (!$imapStream) {
    die("IMAP连接失败：" . imap_last_error());
}

// 读取邮件（示例：读取全部邮件）
$emailIds = imap_search($imapStream, 'ALL');
if ($emailIds) {
    rsort($emailIds); // 按时间倒序，先读最新邮件
    foreach ($emailIds as $id) {
        $header = imap_headerinfo($imapStream, $id);
        // 提取所需字段
        $from = $header->from[0]->mailbox . "@" . $header->from[0]->host;
        $to = implode(', ', array_map(function($addr) {
            return $addr->mailbox . "@" . $addr->host;
        }, $header->to));
        $subject = imap_utf8($header->subject);
        $sendTime = date('Y-m-d H:i:s', strtotime($header->date));
        
        // 插入自研CMS的代码，示例：
        // $pdo->prepare("INSERT INTO email_records (from_addr, to_addr, subject, send_time) VALUES (?, ?, ?, ?)")
        //     ->execute([$from, $to, $subject, $sendTime]);
    }
}

imap_close($imapStream);

方式2：第三方库实现（推荐，更简洁稳定） #

使用league/oauth2-client处理OAuth2流程，php-imap/php-imap简化IMAP操作：

1. 安装依赖

composer require league/oauth2-client php-imap/php-imap

2. 实现代码

require 'vendor/autoload.php';

use League\OAuth2\Client\Provider\GenericProvider;
use PhpImap\Mailbox;

$tenantId = "你的租户ID";
$clientId = "你的客户端ID";
$clientSecret = "你的客户端密码";
$targetEmail = "你的Office365邮箱地址";

// 初始化OAuth2提供者
$oauthProvider = new GenericProvider([
    'clientId'                => $clientId,
    'clientSecret'            => $clientSecret,
    'urlAuthorize'            => "https://login.microsoftonline.com/$tenantId/oauth2/v2.0/authorize",
    'urlAccessToken'          => "https://login.microsoftonline.com/$tenantId/oauth2/v2.0/token",
    'urlResourceOwnerDetails' => '',
    'scopes'                  => 'https://outlook.office365.com/.default'
]);

// 获取访问令牌
$accessToken = $oauthProvider->getAccessToken('client_credentials');

// 连接IMAP邮箱
$mailbox = new Mailbox(
    '{outlook.office365.com:993/imap/ssl}',
    $targetEmail,
    $accessToken->getToken(),
    __DIR__ . '/tmp' // 临时缓存目录，需确保有写入权限
);

try {
    $mailIds = $mailbox->searchMailbox('ALL');
    rsort($mailIds);
    foreach ($mailIds as $id) {
        $mail = $mailbox->getMail($id);
        $from = $mail->fromAddress;
        $to = implode(', ', $mail->toAddresses);
        $subject = $mail->subject;
        $sendTime = date('Y-m-d H:i:s', $mail->date);
        
        // 插入CMS的逻辑代码
    }
} catch (\PhpImap\Exceptions\ConnectionException $e) {
    die("连接失败：" . $e->getMessage());
}

关键注意事项 #

• 服务器需满足：PHP版本≥7.4，开启imap和curl扩展
• 令牌有效期为1小时，建议实现本地缓存（比如存Redis或文件），避免重复请求令牌
• 客户端凭据流（上述方案使用的方式）需要Azure AD管理员授予应用权限，确保目标邮箱允许该应用访问
• 批量读取邮件时建议分页处理，避免超时或内存溢出
• 若遇到权限错误，检查Azure AD的API权限是否已完成「授予管理员同意」，以及应用的权限范围是否正确

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