PHP 7.4 源码编译：解决 DOMDocument 扩展缺失的正确姿势

本文详细阐述了在从源码编译 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 源码编译的完整步骤：

1. 安装编译依赖 首先，确保系统安装了所有必要的编译工具和库。

   sudo yum install -y autoconf bison re2c libxml2-devel gcc git

   注意：libxml2-devel 包提供了 libxml2 的开发头文件和库，这是编译 PHP 扩展所必需的。

   

   剪映

   一款全能易用的桌面端剪辑软件

   下载

2. 获取 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'

3. 生成配置脚本 运行 buildconf 来生成 configure 脚本。

   ./buildconf

4. 配置编译选项 这是最关键的一步。使用正确的 configure 命令，显式启用 DOM 扩展。这里我们还额外包含了 curl 扩展作为示例。

   ./configure --disable-all --disable-cgi --enable-cli --with-curl --with-libxml --enable-dom

5. 编译 PHP 执行 make 命令进行编译。-j $(nproc) 参数可以利用多核 CPU 加速编译过程。

   make clean && \
   make -j $(nproc)

6. 安装 PHP 二进制文件 将编译好的 PHP CLI 二进制文件复制到目标位置。

   rm -rfv ../php && \
   cp -v ./sapi/cli/php ../php

   此时，../php/php 就是我们编译好的 PHP 7.4 CLI 可执行文件。

验证 DOMDocument 扩展

编译完成后，可以通过以下方法验证 DOMDocument 扩展是否已成功集成：

1. 通过 php -m 命令检查已加载的模块

   ../php/php -m | grep dom

   如果输出中包含 dom，则表示 DOM 扩展已成功加载。

2. 通过 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。