Laravel集成Webklex\PHPIMAP获取邮件Ubuntu服务器编码异常如何处理

你看到的=?UTF-8?B?UHJlcCBTcG9ydHN3ZWFy?=是标准的MIME邮件头编码格式，B代表内容用Base64编码，本地环境因为装了对应依赖且扩展默认开启了自动解码所以输出正常，服务器环境缺少对应依赖或者没有配置自动解码就会输出原始编码内容。

1. 安装服务器缺失的PHP扩展 #

Webklex\PHPIMAP依赖mbstring和iconv扩展做编码处理，Ubuntu环境默认可能未安装，执行以下命令安装：

sudo apt update && sudo apt install php-mbstring php-iconv

安装完成后重启PHP-FPM或Web服务生效。

2. 调整客户端配置开启自动解码 #

初始化Client时添加解码相关配置，开启头信息自动解码：

$client = new Client([
    'host' => '************',
    'port' => 993,
    'encryption' => 'ssl',
    'validate_cert' => true,
    'username' => '***********',
    'password' => '***********',
    'authentication' => 'oauth2',
    'protocol' => 'imap',
    // 新增解码配置
    'options' => [
        'decode_headers' => true,
        'decode_body' => true,
    ]
]);

如果你使用Laravel的扩展配置文件config/imap.php，直接修改配置项decode_headers为true即可。

3. 代码层面手动解码（可选） #

如果配置调整后仍不生效，可以直接在输出时手动调用解码方法处理：

foreach ($messages as $m){
    $personalRaw = $m->getAttributes()['from'][0]->personal;
    // 调用PHP内置imap扩展方法解码MIME头
    $decodedParts = imap_mime_header_decode($personalRaw);
    $personalName = '';
    foreach ($decodedParts as $part) {
        $personalName .= mb_convert_encoding($part->text, 'UTF-8', $part->charset ?: 'UTF-8');
    }
    echo $personalName;
}

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