如何通过php-ews获取Exchange Server版本，解决版本不匹配报错

这个问题我之前帮不少开发者处理过——固定指定VERSION_2016确实会因为用户的Exchange服务器版本不同抛出「The specified server version is invalid」错误。好在php-ews提供了两种可靠的方式来动态获取服务器版本，完美解决这个问题：

方案一：用Autodiscover自动探测服务器版本（推荐） #

Autodiscover是Exchange自带的服务，不仅能自动定位服务器地址，还能返回服务器的版本信息。先通过它拿到版本，再创建对应版本的Client实例：

use jamesiarmes\PhpEws\Client;
use jamesiarmes\PhpEws\AutodiscoverService;
use jamesiarmes\PhpEws\Request\GetUserSettingsType;

// 从用户个人资料取到的账户信息
$email = '{username_set_on_users_profile}'; // 建议用用户邮箱（通常和用户名一致）
$password = '{password_set_on_users_profile}';
$host = '{host_set_on_users_profile}';
$timezone = '{your_app_timezone}';

// 初始化Autodiscover服务
$autodiscover = new AutodiscoverService();
$autodiscover->setCredentials($email, $password);

// 请求获取服务器版本设置
$request = new GetUserSettingsType();
$request->UserSettings->add('ServerVersion');
$request->UserMailbox = $email;

try {
    $response = $autodiscover->GetUserSettings($request);
    
    // 从响应里提取服务器版本字符串
    $serverVersion = $response->Response->UserSettings->UserSetting->Value;
    
    // 把Exchange版本映射到php-ews的常量
    $versionMap = [
        'Exchange2010' => Client::VERSION_2010,
        'Exchange2013' => Client::VERSION_2013,
        'Exchange2016' => Client::VERSION_2016,
        'Exchange2019' => Client::VERSION_2019,
        'Exchange2007_SP1' => Client::VERSION_2007_SP1,
    ];
    
    // 找不到对应版本就 fallback 到2016
    $selectedVersion = $versionMap[$serverVersion] ?? Client::VERSION_2016;
    
    // 用正确版本创建Client实例
    $client = new Client($host, $email, $password, $selectedVersion);
    $client->setTimezone($timezone);
    
    // 继续你的日历事件查询逻辑
    $request = new FindItemType();
    // ...你的请求构建代码
    $response = $client->FindItem($request);
    
} catch (\Exception $e) {
    // Autodiscover失败的话，可以回退到方案二，或者提示用户检查账户
    error_log('Autodiscover失败: ' . $e->getMessage());
}

方案二：版本降级尝试（Autodiscover不可用时用） #

如果用户的Exchange服务器不支持Autodiscover，就从最高版本到最低版本逐个尝试，直到找到能正常连接的版本：

use jamesiarmes\PhpEws\Client;

// 用户账户信息
$host = '{host_set_on_users_profile}';
$username = '{username_set_on_users_profile}';
$password = '{password_set_on_users_profile}';
$timezone = '{your_app_timezone}';

// 按从新到旧的顺序定义版本列表
$versions = [
    Client::VERSION_2019,
    Client::VERSION_2016,
    Client::VERSION_2013,
    Client::VERSION_2010,
    Client::VERSION_2007_SP1,
];

$validClient = null;

foreach ($versions as $version) {
    try {
        $tempClient = new Client($host, $username, $password, $version);
        $tempClient->setTimezone($timezone);
        
        // 发送一个简单的验证请求，比如查询日历文件夹
        $folderRequest = new \jamesiarmes\PhpEws\Request\FindFolderType();
        $folderRequest->Traversal = 'Shallow';
        $folderRequest->FolderShape = new \jamesiarmes\PhpEws\Type\FolderResponseShapeType();
        $folderRequest->FolderShape->BaseShape = 'Default';
        $folderRequest->ParentFolderIds = new \jamesiarmes\PhpEws\Type\NonEmptyArrayOfBaseFolderIdsType();
        $folderRequest->ParentFolderIds->DistinguishedFolderId = new \jamesiarmes\PhpEws\Type\DistinguishedFolderIdType();
        $folderRequest->ParentFolderIds->DistinguishedFolderId->Id = 'calendar';
        
        // 如果请求成功，说明版本匹配
        $tempClient->FindFolder($folderRequest);
        $validClient = $tempClient;
        break;
    } catch (\Exception $e) {
        // 当前版本无效，继续尝试下一个
        continue;
    }
}

if ($validClient) {
    // 版本验证通过，继续处理日历事件
    $request = new FindItemType();
    // ...你的请求代码
    $response = $validClient->FindItem($request);
} else {
    // 所有版本都失败，提示用户检查账户信息
    echo '无法匹配Exchange服务器版本，请检查你的账户详情';
}

小提示 #

• 优先用方案一，Autodiscover是官方推荐方式，性能更好也更准确。
• 确保你的php-ews库是最新版，旧版本可能对某些Exchange版本的支持有缺陷。
• 如果用户使用的是Office 365（Exchange Online），Autodiscover肯定能用，而且版本可以直接用Client::VERSION_EXCHANGE_2016或者VERSION_EXCHANGE_ONLINE。

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