本文旨在解决在php 7.4源码编译过程中，尤其是在使用`--disable-all`参数时，domdocument扩展未能正确启用的问题。我们将详细阐述，除了`--with-libxml`之外，还必须明确指定`--enable-dom`参数，才能确保domdocument类在编译后的php二进制文件中可用。文章将提供完整的编译步骤、示例代码和验证方法。
PHP 7.4源码编译与DOMDocument启用详解
在从源码编译PHP时，开发者常常需要根据特定需求选择性地启用或禁用各种扩展。然而，在PHP 7.4版本中，当使用--disable-all参数进行最小化编译时，许多人可能会发现，即使指定了--with-libxml，DOMDocument类仍然不可用，导致运行时出现Fatal error: Uncaught Error: Class 'DOMDocument' not found的错误。这通常是由于对PHP扩展编译机制的误解所致。
问题根源分析
DOMDocument是PHP的一个内置扩展，它依赖于libxml库来解析和操作XML/HTML文档。因此，直观上会认为只要通过--with-libxml参数指定了libxml库的路径，DOMDocument就应该随之被启用。然而，当使用--disable-all参数时，PHP的编译系统会默认禁用所有非核心的扩展，包括DOM。--with-libxml仅仅是告诉PHP编译系统libxml库在哪里，以便那些依赖它的扩展（如DOM）能够找到并链接到它，但它本身并不会主动启用依赖libxml的扩展。要明确启用DOM扩展，需要显式地使用--enable-dom参数。
正确启用DOMDocument的编译方法
为了在PHP 7.4源码编译时正确启用DOMDocument，我们需要在./configure命令中同时指定--with-libxml和--enable-dom。以下是一个完整的编译示例，适用于Amazon Linux 2或类似的基于RPM的Linux发行版。
1. 安装编译依赖
立即学习“PHP免费学习笔记（深入）”；
首先，确保系统安装了所有必要的编译工具和库。特别是libxml2-devel（或libxml2-dev）是--with-libxml参数正常工作的关键。
sudo yum install -y autoconf bison re2c libxml2 libxml2-devel gcc git
- autoconf, bison, re2c: 用于生成PHP编译脚本。
- libxml2, libxml2-devel: 提供XML解析功能及其开发头文件，DOM扩展所必需。
- gcc: C语言编译器。
- git: 用于克隆PHP源码。
2. 获取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'
这会克隆PHP 7.4分支的最新源码。
3. 配置、编译和安装PHP
这是核心步骤。请注意./configure命令中的--enable-dom参数。
./buildconf --force && \ # 重新生成配置脚本，确保干净 ./configure --disable-all --enable-cli --with-curl --with-libxml --enable-dom && \ make clean && \ make -j $(nproc) && \ rm -rfv ../php && \ cp -v ./sapi/cli/php ../php
- ./buildconf --force: 确保生成最新的configure脚本。
- --disable-all: 禁用所有默认扩展，实现最小化编译。
- --enable-cli: 启用CLI SAPI，这是最常见的PHP命令行接口。
- --with-curl: 启用cURL扩展，此处作为示例，表明其他扩展可以类似地添加。
- --with-libxml: 指定libxml库的路径（如果系统默认路径，只需--with-libxml即可）。
- --enable-dom: 关键所在，明确启用DOM扩展。
- make clean: 清理之前的编译残留。
- make -j $(nproc): 使用所有可用的CPU核心进行并行编译，加速过程。
- rm -rfv ../php && cp -v ./sapi/cli/php ../php: 将编译好的PHP CLI二进制文件复制到上级目录，方便管理。
验证DOMDocument是否成功启用
编译完成后，可以通过以下命令验证DOMDocument扩展是否已成功启用：
../php -m | grep -i dom
如果输出中包含dom，则表示DOM扩展已成功加载。
或者，可以运行一个简单的PHP脚本来测试：
将上述代码保存为test_dom.php，然后运行：
../php test_dom.php
如果输出显示DOMDocument class is available.，则表示一切正常。
注意事项与最佳实践
- 依赖库的完整性： 确保所有--with-xxx或--enable-xxx参数所需的开发库（通常是-devel或-dev包）都已安装。缺少这些库会导致配置失败或编译出的PHP功能不完整。
- --disable-all的含义： 使用此参数意味着您需要手动启用所有您需要的扩展。这有助于创建一个精简的PHP环境，但也要求您对所需功能有清晰的了解。
- 路径管理： 如果您希望将PHP安装到特定目录（例如/usr/local/php74），可以使用--prefix=/path/to/install参数。
- 生产环境考量： 对于生产环境，除了CLI，可能还需要FPM SAPI (--enable-fpm)。同时，通常还会启用--with-pdo-mysql, --with-mysqli, --with-openssl等常用扩展。
- 错误排查： 如果编译过程中出现错误，仔细检查config.log文件。它会记录configure脚本运行时的详细信息，包括失败原因和缺失的依赖库。
总结
在PHP 7.4源码编译中，当采用--disable-all策略时，为了确保DOMDocument扩展的可用性，务必在./configure命令中同时包含--with-libxml和--enable-dom。理解--disable-all的严格性以及各扩展参数的独立作用是成功定制PHP编译的关键。通过遵循本文提供的步骤和注意事项，您可以构建一个满足特定需求的、功能完整的PHP环境。
