本文详细阐述了在从源码编译 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）：<?php try { $dom = new DOMDocument(); echo "DOMDocument 类已成功实例化。/n"; $dom->loadXML('<root><item/></root>'); 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中文网其它相关文章！