PHP 8.1+ 废弃 libxml_disable_entity_loader()，因其功能已由 libxml 2.9.0+ 默认禁用外部实体实现；应改用 LIBXML_NO_XXE 等常量控制解析行为，避免报错及安全风险。
PHP 8.1 及以上版本中 libxml_disable_entity_loader() 已被彻底弃用，直接调用会触发 Deprecated: Function libxml_disable_entity_loader() is deprecated 报错 —— 不能删了就跑，也不能硬加 @ 符号压制，必须按新版 libxml 行为重写 XML 解析逻辑。
为什么 PHP 8.1 会报这个错
从 libxml 2.9.0 开始（PHP 8.0+ 默认绑定），外部实体加载已默认禁用，libxml_disable_entity_loader() 失去存在意义，PHP 官方将其标记为废弃。继续调用不仅报错，还可能掩盖真实 XXE 漏洞风险。
- 不是“功能坏了”，而是“功能已内置且更安全”
- 旧代码里常见的
libxml_disable_entity_loader(true)+simplexml_load_string()组合，在 PHP 8.1 下属于冗余且非法操作 - 若你同时用
SoapClient或XSLTProcessor，旧式调用还会导致 WSDL/XSD 加载失败
替换 libxml_disable_entity_loader() 的安全写法
核心原则：不干预加载器开关，改用 libxml 常量控制解析行为。推荐两种场景化方案：
- 普通 XML 字符串解析（如微信支付回调）：
用LIBXML_NO_XXE（PHP ≥ 8.4）或降级兼容写法：if (PHP_VERSION_ID < 80400) { // 兼容 PHP 8.0–8.3：禁用外部实体 + 清理空白 + 不加载 DTD $options = LIBXML_NOCDATA | LIBXML_NOBLANKS | LIBXML_NONET; } else { $options = LIBXML_NOCDATA | LIBXML_NOBLANKS | LIBXML_NO_XXE; } $result = simplexml_load_string($xml, 'SimpleXMLElement', $options); - 需要保留内部实体（如
<!ENTITY foo "bar">）但禁外部实体：
改用libxml_set_external_entity_loader()自定义空处理器：libxml_set_external_entity_loader(function ($public, $system, $context) { return false; // 拒绝所有外部实体加载 }); $result = simplexml_load_string($xml);
fastadmin 微信支付报错的典型修复点
fastadmin 的微信支付模块常在 Wxpay.php 或回调处理处硬编码 libxml_disable_entity_loader(true)，PHP 8.1 下必挂。修复时注意三点：
立即学习“PHP免费学习笔记（深入）”；
- 删掉所有裸调用
libxml_disable_entity_loader()的行，包括包裹它的if (version_compare(PHP_VERSION, '8.0') 判断 —— 这种兼容写法在 8.1 下仍会执行并报错 -
simplexml_load_string()必须显式传入LIBXML_NONET（或LIBXML_NO_XXE），否则即使 PHP 8.1 默认禁用，某些 XML 内容仍可能触发警告 - 不要用
json_decode(json_encode(...))曲线救国：它会丢失 SimpleXML 对象方法、命名空间和 CDATA，导致后续签名验签失败
容易被忽略的兼容性陷阱
很多人以为只要 PHP 版本判断够细就万事大吉，其实还有几个隐性坑：
-
LIBXML_NONET在 PHP 8.0+ 虽可用，但它会同时禁用http://和https://外部引用 —— 如果你的 XML 里有合法的在线 DTD（极少见但存在），得单独处理 -
libxml_set_external_entity_loader()是全局生效的，必须确保它不会被其他组件（比如某 SDK 的初始化脚本）覆盖或重置 - 如果你用的是
DOMDocument::loadXML()，同样要传LIBXML_NO_XXE，而不是依赖构造函数参数或事后调用禁用函数
最稳妥的做法：所有 XML 解析入口统一走封装函数，强制注入安全选项，不给裸调 simplexml_load_string 或 DOMDocument::loadXML 留口子。
