DOMDocument扩展在phpEnv中默认不启用，需手动在对应版本的php.ini中取消extension=dom注释或添加该行，并确认libxml2-dev已安装、extension_dir路径正确，最后执行phpenv rehash验证。
phpEnv 下 DOMDocument 扩展默认不启用
phpEnv 是一个用于快速切换 PHP 版本的本地环境工具，但它不会自动启用所有扩展 —— 即使是 DOMDocument 这类常被误认为“内置”的核心类。它实际依赖 dom 扩展（由 libxml 支持），而 phpEnv 安装的二进制包通常只启用最精简的扩展集。
确认当前 PHP 是否加载了 dom 扩展
别直接改配置，先验证现状：
- 运行
php -m | grep -i dom—— 如果无输出，说明未加载 - 运行
php -i | grep "dom.so"—— 看是否在 extension_dir 中存在但未启用 - 运行
php --ini查看实际生效的php.ini路径，注意 phpEnv 可能为每个版本维护独立 ini 文件（如~/.phpenv/versions/8.2.12/etc/php.ini）
手动启用 dom 扩展（phpEnv 场景）
phpEnv 不提供 apt 或 yum 管理，扩展必须通过配置文件启用：
- 打开对应 PHP 版本的
php.ini（用php --ini确认路径） - 查找
;extension=dom或;extension=dom.so行，取消注释 - 如果该行不存在，手动添加
extension=dom（PHP 8+ 推荐不带.so后缀） - 保存后执行
phpenv rehash，再用php -m | grep dom验证 - 若仍失败，检查
extension_dir路径是否正确 —— phpEnv 的扩展目录通常在~/.phpenv/versions/x.x.x/lib/php/extensions/no-debug-zts-xxxxx/，确认该目录下存在dom.so
编译安装时漏掉 libxml 导致 dom 无法启用
如果你用 phpEnv 的 php-build 自定义编译过 PHP，dom 扩展依赖系统级 libxml2-dev（Debian/Ubuntu）或 libxml2-devel（CentOS/RHEL）。没装它，即使写了 --with-dom，configure 阶段也会静默跳过 dom 支持。
立即学习“PHP免费学习笔记（深入）”；
- Debian/Ubuntu：运行
sudo apt-get install libxml2-dev - CentOS/RHEL：运行
sudo yum install libxml2-devel（或dnf install libxml2-devel） - 重装 PHP 版本：
phpenv install --reinstall 8.2.12 - 编译参数中显式加
--with-dom并非必需（现代 PHP 默认启用），但确保libxml2头文件可用才是关键
最容易被忽略的是：phpEnv 的不同 PHP 版本彼此隔离，改了一个版本的 php.ini 不影响其他版本；另外，CLI 和 Web SAPI（如 Apache/Nginx + PHP-FPM）可能加载不同的 php.ini，务必用 phpinfo() 页面确认 Web 环境实际加载的配置路径。
