PHP无法原生解析RTF,需通过转换实现:推荐方案一是用unrtf等命令行工具转为文本/HTML后清洗;方案二是Windows下调用COM+Word精准提取;不推荐纯PHP库因缺乏成熟维护;最佳实践是规避RTF,改用DOCX或结构化数据。

PHP 本身不内置 RTF 解析能力,也没有官方扩展直接读取 RTF 内容。实际项目中,读取 RTF 文件主要靠“转换”而非“原生解析”,核心思路是把 RTF 转成可处理的格式(如纯文本或 HTML),再用 PHP 加载、清洗、展示。
推荐方案一:命令行工具 + shell_exec()
这是最轻量、兼容性好、无需复杂依赖的方式,适合 Linux/Unix 环境:
- 安装开源命令行工具 rtf2html(如
sudo apt install unrtf,它默认输出 HTML)或 unrtf(支持 --text 输出纯文本) - 上传 RTF 后,用
shell_exec()调用转换命令,例如:$text = shell_exec('unrtf --text ' . escapeshellarg($tmp_path) . ' 2>/dev/null'); - 注意过滤空字符、控制字符和多余换行,可用
trim(preg_replace('/\s+/', ' ', $text))简单清洗
推荐方案二:COM 扩展调用 Word(仅 Windows)
利用本地 Microsoft Word 引擎精准提取内容,适合对格式还原要求不高、但需要高准确率的场景:
- 需启用 PHP 的 com_dotnet 扩展(
extension=php_com_dotnet.dll) - 确保服务器安装了 Word(2007 及以上),且 DCOM 权限配置正确(NETWORK SERVICE 有启动/激活权限)
- 代码示例:
$word = new COM('Word.Application');
$doc = $word->Documents->Open($rtfPath, false, true);
$text = $doc->Content->Text;
$doc->Close(false); $word->Quit();
不推荐依赖的“纯 PHP 库”
目前没有成熟、持续维护、能稳定处理复杂 RTF(含表格、嵌套样式、中文编码)的纯 PHP 解析库:
立即学习“PHP免费学习笔记(深入)”;
- 网上零星的
RTFParser类多为半成品,不支持 Unicode 或会崩溃于真实文档 - LiveDocx 已停止维护,且只支持旧版 RTF;phpoffice 系列(PhpWord)专注生成,不提供 RTF 读取能力
- 试图手动解码 Base64 编码的 RTF 字符串(如
e1xydGY...)不可靠——RTF 不是标准 Base64,而是自定义十六进制转义,解析极易出错
替代思路:绕过 RTF,改用中间格式
如果控制文件来源,建议前端或上传环节就规避 RTF:
- 让用户上传 DOCX(用 PhpWord 读取)或纯文本(
file_get_contents直接读) - 服务端生成 RTF 前,先存一份结构化数据(JSON/数据库),展示时直接读结构化内容,避免解析开销
- 若必须对接 Google Docs,可借助 Google Drive API 直接上传 RTF 并设置
convert=true,由 Google 后端转为 Google Doc,再用 Docs API 读取正文











