在从源码编译php 7.4时，即使指定了`--with-libxml`，`domdocument`类也可能因使用了`--disable-all`而缺失。本文将详细指导如何通过在`./configure`命令中额外添加`--enable-dom`选项来正确启用dom扩展，从而确保`domdocument`等相关功能在编译后的php cli二进制文件中可用，并提供完整的编译步骤和验证方法。
理解PHP源码编译中的扩展启用机制
当从源码编译PHP时，./configure脚本用于准备编译环境并决定哪些功能和扩展将被包含在最终的PHP二进制文件中。--disable-all是一个非常强大的选项，它会禁用所有默认开启的扩展，只保留核心功能。这意味着，即使某些扩展依赖于特定的库（如DOM依赖于libxml2），仅仅通过--with-libxml指定库路径，并不能自动启用依赖该库的扩展。
--with-libxml选项的作用是告诉PHP构建系统libxml2库的位置，以便DOM扩展能够正确链接到它。然而，DOM扩展本身，作为一个独立的模块，在使用--disable-all的情况下，需要通过--enable-dom明确地指示编译系统将其包含进来。如果缺少--enable-dom，即使libxml2库已正确配置，DOM扩展也不会被编译和启用，导致DOMDocument类在运行时无法找到。
解决DOMDocument缺失问题
要解决PHP 7.4源码编译后DOMDocument类缺失的问题，关键在于在./configure命令中同时指定--with-libxml和--enable-dom。以下是完整的编译步骤：
-
准备编译环境与依赖
立即学习“PHP免费学习笔记（深入）”；
首先，确保您的系统（例如Amazon Linux 2）安装了必要的编译工具和库。
yum install autoconf bison re2c libxml2-devel gcc -y
- autoconf, bison, re2c: 用于生成构建系统文件。
- libxml2-devel: 提供libxml2库的开发文件（头文件和静态库），这是DOM扩展所必需的。
- gcc: C语言编译器。
-
获取PHP 7.4源码
从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
-
配置PHP编译选项
这是最关键的一步。请确保在./configure命令中包含--enable-dom。
./configure --disable-all --enable-cli --with-curl --with-libxml --enable-dom
- --disable-all: 禁用所有默认扩展。
- --enable-cli: 启用CLI SAPI（命令行接口）。
- --with-curl: 启用cURL扩展（作为示例，如果您需要）。
- --with-libxml: 指定libxml2库的支持。
- --enable-dom: 明确启用DOM扩展。
-
编译PHP
执行make命令进行编译。-j $(nproc)选项可以利用多核CPU加速编译过程。
make clean && \ make -j $(nproc)
-
安装或复制编译后的二进制文件
将编译好的PHP CLI二进制文件复制到您指定的位置。
rm -rfv ../php && \ cp -v ./sapi/cli/php ../php
验证DOMDocument可用性
编译完成后，您可以通过以下方法验证DOMDocument是否已成功启用：
-
检查已加载的模块
运行编译后的PHP二进制文件，查看已加载的模块列表：
/path/to/your/php -m | grep dom
如果输出中包含dom，则表示DOM扩展已成功加载。
-
执行PHP代码进行测试
创建一个简单的PHP文件（例如test_dom.php）：
<?php try { $dom = new DOMDocument(); echo "DOMDocument is available and can be instantiated.\n"; // 进一步测试，例如加载XML $dom->loadXML('<root><item>test</item></root>'); echo "XML loaded successfully.\n"; } catch (Error $e) { echo "Error: " . $e->getMessage() . "\n"; } ?>然后运行该文件：
/path/to/your/php test_dom.php
如果输出显示“DOMDocument is available and can be instantiated.”和“XML loaded successfully.”，则说明DOM扩展已正常工作。
注意事项与总结
- --disable-all的含义：务必理解--disable-all会禁用所有默认扩展。这意味着除了您明确启用的扩展外，其他常用功能（如json, mbstring, pdo等）也需要通过各自的--enable-xxx或--with-xxx选项来手动启用。
- 依赖库的-devel包：当启用一个需要外部库的PHP扩展时（例如--with-libxml，--with-curl），通常需要安装该库的开发包（在基于RPM的系统上通常是-devel后缀，如libxml2-devel；在基于Debian的系统上通常是-dev后缀，如libxml2-dev）。这些包提供了编译时所需的头文件和链接库。
- config.log文件：如果编译过程中遇到问题或某个扩展未能如预期般工作，php-src目录下的config.log文件是重要的调试资源。它记录了./configure脚本执行的详细过程，包括对依赖库的检查结果，可以帮助定位问题。
通过上述步骤，您应该能够成功地在从源码编译的PHP 7.4版本中启用DOM扩展，并使用DOMDocument类来处理XML和HTML文档。关键在于理解--disable-all的限制以及如何通过--enable-dom明确地包含所需的扩展。
