必须显式添加--enable-dom，仅--with-libxml不足以启用DOMDocument；编译时需同时指定--with-libxml和--enable-dom，否则即使libxml2可用，仍会报“Class 'DOMDocument' not found”错误。
phpEnv 默认不启用 DOM 扩展，必须手动开启；否则 new DOMDocument() 会直接报错 Fatal error: Class 'DOMDocument' not found。
确认 phpEnv 当前是否已加载 DOM 扩展
进入 phpEnv 环境的 CLI 或 Web 环境，执行：
php -m | grep dom
若无输出，说明未启用。也可用以下代码验证：
<?php var_dump(class_exists('DOMDocument')); ?>
返回 false 即未就绪。注意：phpEnv 的不同 PHP 版本（如 7.4 / 8.1 / 8.3）各自有独立的配置路径，别改错版本目录。
在 phpEnv 中启用 DOM 扩展的两种方式
phpEnv 本质是多版本 PHP 环境管理器，它不自己编译 PHP，而是调用系统已安装的 PHP 二进制或预编译包。因此启用 DOM 的方式取决于底层 PHP 是如何构建的：
- 如果底层 PHP 是通过系统包管理器（如
apt install php-xml）安装的：DOM 通常随php-xml包一同提供，只需确保该扩展被php.ini加载 - 如果底层 PHP 是源码编译且用了
--disable-all：仅装libxml2-dev不够，必须重新编译并显式加--enable-dom（否则即使--with-libxml存在也无效）
绝大多数 phpEnv 用户属于前者——直接编辑对应版本的 php.ini 即可。
编辑 php.ini 启用 extension=dom
先定位当前 phpEnv 使用的 php.ini：
php --ini
输出类似：Loaded Configuration File: /path/to/phpenv/versions/8.2.10/etc/php.ini。打开该文件，查找：
;extension=dom
去掉分号，并确认其未被注释为 ;extension=dom.so 或 ;extension=php_dom.dll（Linux 用前者，Windows 用后者）。保存后重启 Web 服务或 CLI 环境。
注意三点：
- 某些 phpEnv 构建的 PHP 可能默认启用了
dom，但禁用了libxml支持——此时需同时确认extension=libxml已启用（虽然现代 PHP 中 libxml 多为内置） - 若仍报错，检查
php -i | grep "libxml version"是否有输出；无输出说明 libxml 模块根本没加载，DOM 无法工作 - Windows 下若用
php_dom.dll，要确保extension_dir指向正确的ext/目录，且 DLL 文件真实存在
DOMDocument::loadHTML() 常见失败原因与绕过技巧
即使 DOM 扩展已启用，DOMDocument::loadHTML() 仍极易返回空文档或 $doc->documentElement === null，主因不是扩展问题，而是 HTML 输入和解析上下文不匹配：
- 输入 HTML 缺少根容器（如只有
loadHTML()会自动包裹...，但若原始内容含 UTF-8 BOM 或编码声明冲突，可能导致解析中断 - 默认按 ISO-8859-1 解析，UTF-8 字符串可能乱码或截断——解决方法是在调用前加
mb_convert_encoding($html, 'HTML-ENTITIES', 'UTF-8')，或强制指定选项：$doc->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD) - 遇到 HTML5 标签（如
）时，libxml 可能报Tag article invalid警告并中止构建 DOM 树；应在解析前调用libxml_use_internal_errors(true)，之后用libxml_get_errors()检查而非忽略
最简健壮写法：
$doc = new DOMDocument();
libxml_use_internal_errors(true);
$doc->loadHTML('<?xml encoding="utf-8"?>' . $html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
libxml_clear_errors();
if (!$doc->documentElement) {
throw new RuntimeException('HTML parse failed');
}
真正容易被忽略的点是：DOM 扩展启用 ≠ HTML 解析可靠；loadHTML() 的容错边界比直觉窄得多，尤其面对真实网页时，必须主动处理编码、隐式结构和标签兼容性。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
