使用 quoted_printable 编码并配合 mime-version 头可以解决中文附件名在 outlook 中的乱码问题。具体做法是在构建邮件时,将附件文件名通过 quoted_printable_encode() 处理,并使用 rfc 2047 标准格式包裹,同时确保邮件头部声明 mime-version: 1.0。这样 outlook 能正确识别编码并还原中文名称。

如何构造符合 RFC 2047 标准的附件名头
Outlook 等客户端依赖邮件头部的 Content-Disposition 或 Content-Type 中的 filename 参数来显示附件名。直接发送 UTF-8 字符串会导致非 ASCII 字符被截断或显示为问号。必须将文件名编码为 格式。对于包含中文的文件名,先进行 quoted_printable_encode 处理,再拼接前后缀。

$filename = "\u6d4b\u8bd5\u6587\u4ef6.txt"; $encoded = quoted_printable_encode($filename); $rfc2047_name = "=?UTF-8?Q?" . $encoded . "?="; $header = "Content-Disposition: attachment; filename=\"$rfc2047_name\"";
上述代码中,$filename 是原始中文路径。quoted_printable_encode 将其转换为安全的 ASCII 字符序列。最终生成的 $header 字符串可直接插入到 SMTP 邮件头的 Content-Disposition 字段中。Outlook 解析时会识别 UTF-8 和 Q 编码标识,自动解码回原始中文。
完整 PHP SMTP 邮件发送示例
为了验证上述方法,需要构建一个完整的 MIME 邮件结构。使用 PHP 的 mail() 函数或原生 SMTP 库时,必须手动组装邮件头和主体。以下示例展示如何使用 PHPMailer 类(常见于 PHP 开发)或直接构造头部来发送带中文附件名的邮件。这里以直接构造头部为例,展示关键部分。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

$to = "recipient@example.com"; $subject = "Test Attachment"; $boundary = "BOUNDARY_12345"; $filename = "\u6d4b\u8bd5\u6587\u4ef6.txt"; $encoded_filename = "=?UTF-8?Q?" . quoted_printable_encode($filename) . "?="; $headers = "MIME-Version: 1.0\r\n"; $headers .= "Content-Type: multipart/mixed; boundary=\"$boundary\"\r\n"; $headers .= "Content-Disposition: attachment; filename=\"$encoded_filename\"\r\n"; $message = "--$boundary\r\n"; $message .= "Content-Type: text/plain; charset=UTF-8\r\n"; $message .= "\r\nThis is the body.\r\n"; $message .= "--$boundary--\r\n"; mail($to, $subject, $message, $headers);
该脚本首先定义边界符 $boundary,然后在 $headers 中声明 MIME-Version 和 Content-Type。附件名经过编码后嵌入 Content-Disposition。邮件主体 $message 遵循 MIME 多部分结构。发送后,Outlook 会正确显示 测试文件.txt 作为附件名,而非乱码。
当文件名包含特殊字符如空格或括号时怎么办
如果中文文件名中包含空格、括号或其他非字母数字字符,quoted_printable_encode 会将它们转换为特定的十六进制或等号形式。例如,空格可能变为 =20。Outlook 通常能正确处理这些编码后的字符,但为了确保兼容性,建议在编码前对文件名进行标准化处理。此外,某些旧版 Outlook 版本可能对长文件名或特定编码组合支持不佳,此时可考虑使用 base64 编码替代 quoted_printable,格式为 =?UTF-8?B?...?=。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










