如何让字符在PHPWord中更安全？&符号致空白页问题求助

这个坑我之前踩过！当你直接把包含&的文本传给PHPWord的addText时，很容易触发OOXML（Word文档的底层格式）的XML解析错误——因为&在XML里是实体的起始符，未转义的话会被当成不完整的实体处理，最终导致生成的文档损坏，出现空白页。

不用逐个字符替换，有个更简便且全面的方法：

方法：转义XML特殊字符 #

使用PHP内置的htmlspecialchars()函数，指定ENT_XML1规则来转义所有XML敏感字符，包括&、<、>等，这样生成的OOXML就能被Word正确解析了。修改你的代码如下：

$section = $document->addSection();
// 截取文本
$output = mb_substr(strip_tags($page['content'][0]['settings']['text']), 0, 1761);
// 转义XML特殊字符，确保内容安全
$safeOutput = htmlspecialchars($output, ENT_XML1, 'UTF-8');
$section->addText($safeOutput);

为什么这个方法有效？ #

• ENT_XML1是专门针对XML的转义规则，会把所有XML语法里的特殊字符转换成对应的实体（比如&转成&），完全符合OOXML的格式要求。
• 相比手动str_replace，这个方法能一次性处理所有潜在的XML特殊字符，避免遗漏其他可能导致问题的符号（比如<、"）。

如果你的文本里原本就有合法的HTML实体（比如 ），strip_tags不会移除它们，这时候htmlspecialchars会把&再次转义成&，导致显示成 。这种情况你可以先解码HTML实体，再转义：

$rawText = strip_tags($page['content'][0]['settings']['text']);
// 先解码HTML实体
$decodedText = htmlspecialchars_decode($rawText, ENT_QUOTES);
$output = mb_substr($decodedText, 0, 1761);
$safeOutput = htmlspecialchars($output, ENT_XML1, 'UTF-8');
$section->addText($safeOutput);

这样就能兼顾两种情况，确保文本在Word里正常显示。

内容的提问来源于stack exchange，提问作者Mayor of the Plattenbaus