PHP不原生支持RTF解析,直接读取仅得原始内容;需用正则提取纯文本、rtf-html-php库转HTML再提取,或借助unrtf/LibreOffice等系统工具预处理。

PHP 本身不原生支持解析 RTF(Rich Text Format)文件,直接用 fopen 或 file_get_contents 只能读取原始二进制/文本内容,无法提取格式化文字、字体、段落等信息;若你遇到“报错”,大概率是误把 RTF 当普通纯文本处理,或用了不兼容的库/方法。下面分场景给出可落地的排查与解决路径。
确认错误类型:是警告、解析失败,还是乱码?
RTF 文件以 {\rtf1 开头,内部含大量控制字(如 \b、\fs24)和十六进制转义。常见错误表现:
- Warning: file_get_contents(): failed to open stream → 文件路径错误、权限不足、编码含中文未转义
- 读出来全是乱码或控制字符(如
\par\pard\plain原样显示)→ 误以为是 HTML 或 UTF-8 文本,实际需解码 RTF 结构 - 调用第三方类(如
rtf-to-html)报Parse error或空输出 → RTF 版本过新(如 Word 2016+ 导出)、含嵌入对象(图片、OLE)、或使用了非标准扩展
轻量级方案:用正则粗略提取纯文本(适合简单 RTF)
若只需提取文字内容(忽略格式),可先去除 RTF 控制指令,再清理空白:
$rtf = file_get_contents('doc.rtf');
// 移除所有 \xxx 控制字、分组括号、注释及十六进制数据
$plain = preg_replace('/\\\\[a-z]+\d*|\\\\\'[0-9a-fA-F]{2}|\\{.*?\\}|\\r\\n|\\r|\\n/', ' ', $rtf);
$plain = preg_replace('/\\s+/', ' ', trim($plain));
echo strip_tags($plain); // 再去标签残留
⚠️ 注意:该方法对含复杂嵌套、Unicode 转义(\uNNNN)或中文 GBK 编码的 RTF 效果有限,仅作临时应急。
立即学习“PHP免费学习笔记(深入)”;
稳定方案:用成熟 RTF 解析器(推荐 rtf-html-php)
GitHub 上较活跃的 rtf-html-php 库可将 RTF 转为 HTML,再用 strip_tags() 或 DOMDocument 提取文本:
- 通过 Composer 安装:
composer require llaville/rtf-html-php - 基础用法:
use Llaville\RtfHtmlPhp\RtfToHtml; $rtf = file_get_contents('doc.rtf'); $converter = new RtfToHtml(); $html = $converter->convert($rtf); echo strip_tags($html); // 纯文本 // 或用 DOM 处理更精准: $dom = new DOMDocument(); @$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD); echo $dom->textContent; - 若报错
Unsupported control word,尝试在初始化时启用宽松模式:new RtfToHtml(true)
绕过解析:转成中间格式再读取(推荐给生产环境)
最可靠的方式不是“PHP 直读 RTF”,而是借助系统工具预处理:
-
Linux/macOS:安装
unrtf(apt install unrtf或brew install unrtf),然后执行:$text = shell_exec("unrtf --text " . escapeshellarg($rtfPath) . " 2>/dev/null"); -
Windows:用 LibreOffice Headless 模式:
soffice --headless --convert-to txt --outdir /tmp doc.rtf,再读取生成的 .txt - 优点:支持几乎所有 RTF 变体,无 PHP 扩展依赖;缺点:需服务器有对应命令行工具且注意安全(
escapeshellarg必须加)
RTF 不是 PHP 的强项,硬啃语法容易踩坑。优先考虑转换思路——要么用专业解析库降级处理,要么交给成熟工具链预处理。选哪种,取决于你的 RTF 来源是否可控、服务器权限是否开放、以及对格式还原度的要求。











