本文详细阐述了在从源码编译 php 7.4 时，domdocument 扩展意外缺失的问题及其解决方案。当使用 `–disable-all` 选项进行编译时，仅依赖 `–with-libxml` 不足以启用 domdocument。核心在于，必须同时明确指定 `–enable-dom` 选项，才能确保 domdocument 及其相关功能被正确编译进 php 二进制文件。文章提供了完整的编译步骤、示例代码和验证方法，帮助开发者顺利构建包含 domdocument 的 php 环境。
引言：PHP 源码编译与 DOMDocument 扩展的常见陷阱
在特定环境中（例如 Amazon Linux 2），为了精简 PHP 运行时，开发者常选择从源码编译 PHP，并利用 –disable-all 选项禁用所有默认扩展，然后按需启用。然而，一个常见的误解是，当需要使用 DOMDocument 类时，仅通过 –with-libxml 选项就足以提供其支持。实际上，尽管 libxml2 是处理 XML 的底层库，也是 DOM 扩展的依赖，但 DOMDocument 本身属于 PHP 的 DOM 扩展，即便 libxml2 已被包含，DOM 扩展也需要显式启用。这导致在编译完成后，尝试实例化 DOMDocument 对象时会遇到“Class ‘DOMDocument’ not found”的致命错误。
DOMDocument 缺失问题解析
当使用以下 configure 命令编译 PHP 7.4 时：
./configure --disable-all --disable-cgi --enable-cli --with-curl --with-libxml
开发者可能会发现 curl_* 函数可用，但 DOMDocument 类却无法找到。这是因为：
–disable-all 选项顾名思义，禁用了所有 PHP 默认捆绑的扩展，包括 DOM 扩展。–with-libxml 选项告诉 PHP 编译器链接到系统中的 libxml2 库。这个库是处理 XML 的基础，但它本身并不直接提供 PHP 的 DOMDocument 类。DOMDocument 是 PHP 的 DOM 扩展的一部分，而这个扩展需要 libxml2 作为其依赖。因此，即使 libxml2 已经链接成功，如果 DOM 扩展本身没有被启用，PHP 就不会编译和提供 DOMDocument 类。
要解决这个问题，关键在于明确告知 PHP 编译器需要启用 DOM 扩展。
立即学习“PHP免费学习笔记（深入）”；
正确的编译配置
要确保 DOMDocument 扩展在 –disable-all 的编译环境下可用，除了 libxml2 的支持外，还需要显式地启用 DOM 扩展。正确的 configure 命令应包含 –enable-dom 选项：
./configure --disable-all --enable-cli --with-libxml --enable-dom
这条命令的含义是：
–disable-all: 禁用所有默认扩展。–enable-cli: 启用命令行接口 SAPI。–with-libxml: 启用 libxml 支持，这是 DOM 扩展的依赖。–enable-dom: 显式启用 DOM 扩展，从而提供 DOMDocument 类。
完整的 PHP 7.4 源码编译流程
以下是在 Amazon Linux 2 环境下，包含 DOMDocument 支持的 PHP 7.4 源码编译的完整步骤：
sudo yum install -y autoconf bison re2c libxml2-devel gcc git
注意：libxml2-devel 包提供了 libxml2 的开发头文件和库，这是编译 PHP 扩展所必需的。
获取 PHP 源码从 GitHub 克隆 PHP 7.4 的源码。
rm -rf php-src && git clone -b 'PHP-7.4' --depth 1 https://github.com/php/php-src.git && cd 'php-src'
生成配置脚本运行 buildconf 来生成 configure 脚本。
./buildconf
配置编译选项这是最关键的一步。使用正确的 configure 命令，显式启用 DOM 扩展。这里我们还额外包含了 curl 扩展作为示例。
./configure --disable-all --disable-cgi --enable-cli --with-curl --with-libxml --enable-dom
编译 PHP执行 make 命令进行编译。-j $(nproc) 参数可以利用多核 CPU 加速编译过程。
make clean && make -j $(nproc)
安装 PHP 二进制文件将编译好的 PHP CLI 二进制文件复制到目标位置。
rm -rfv ../php && cp -v ./sapi/cli/php ../php
此时，../php/php 就是我们编译好的 PHP 7.4 CLI 可执行文件。
验证 DOMDocument 扩展
编译完成后，可以通过以下方法验证 DOMDocument 扩展是否已成功集成：
通过 php -m 命令检查已加载的模块
../php/php -m | grep dom
如果输出中包含 dom，则表示 DOM 扩展已成功加载。
通过 PHP 脚本测试创建一个简单的 PHP 文件（例如 test_dom.php）：
loadXML(''); echo "XML 已成功加载。n";} catch (Error $e) { echo "发生错误： " . $e->getMessage() . "n";} catch (Exception $e) { echo "发生异常： " . $e->getMessage() . "n";}?>
然后运行此脚本：
../php/php test_dom.php
如果输出显示“DOMDocument 类已成功实例化。”和“XML 已成功加载。”，则说明 DOM 扩展工作正常。如果仍然出现“Class ‘DOMDocument’ not found”的错误，则需要重新检查编译步骤。
注意事项与总结
–disable-all 的影响深远：使用 –disable-all 意味着你需要手动启用每一个所需的扩展。这提供了极致的定制性，但也要求开发者对所需扩展有清晰的认识。依赖关系：某些扩展（如 DOM）依赖于其他库（如 libxml2）。在 configure 阶段，需要确保这些依赖库的开发包（例如 libxml2-devel）已正确安装，并且通过 –with-xxx 选项指定其路径（如果不在标准位置）。查看 config.log：如果在编译过程中遇到问题，php-src/config.log 文件是排查错误的重要资源。它记录了 configure 脚本的详细输出和错误信息。模块化编译：PHP 的设计允许将扩展作为共享模块（.so 文件）进行编译，并在 php.ini 中动态加载。如果不想将 DOM 扩展静态编译进 PHP 二进制文件，可以尝试 –enable-dom=shared，然后通过 extension=dom.so 在 php.ini 中加载。但在精简 CLI 环境中，静态编译通常更直接。
通过本文的指导，开发者应能清晰理解在从源码编译 PHP 7.4 时如何正确地启用 DOMDocument 扩展，避免因配置不当而导致的功能缺失问题。核心要点是：当使用 –disable-all 时，除了依赖库，务必显式启用所需的 PHP 扩展，例如 –enable-dom。
以上就是PHP 7.4 源码编译：解决 DOMDocument 扩展缺失的正确姿势的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1330216.html
微信扫一扫 
支付宝扫一扫 
