在PHP 7.4源码编译中启用DOMDocument的指南-php教程-PHP中文网

在PHP 7.4源码编译中启用DOMDocument的指南

花韻仙語

发布： 2025-11-10 11:43:27

原创

443人浏览过

在PHP 7.4源码编译中启用DOMDocument的指南

在从源码编译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

有道翻译AI助手
有道翻译提供即时免费的中文、英语、日语、韩语、法语、德语、俄语、西班牙语、葡萄牙语、越南语、印尼语、意大利语、荷兰语、泰语全文翻译、网页翻译、文档翻译、PDF翻

63

查看详情

执行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明确地包含所需的扩展。

以上就是在PHP 7.4源码编译中启用DOMDocument的指南的详细内容，更多请关注php中文网其它相关文章！