在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。以下是完整的编译步骤：

1. 准备编译环境与依赖

   立即学习“PHP免费学习笔记（深入）”；

   首先，确保您的系统（例如Amazon Linux 2）安装了必要的编译工具和库。

   yum install autoconf bison re2c libxml2-devel gcc -y

   • autoconf, bison, re2c: 用于生成构建系统文件。
   • libxml2-devel: 提供libxml2库的开发文件（头文件和静态库），这是DOM扩展所必需的。
   • gcc: C语言编译器。

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

3. 生成构建配置

   运行./buildconf来生成configure脚本。

   ./buildconf

4. 配置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扩展。

5. 编译PHP

   

   Proface Avatarize

   一个利用AI技术提供高质量专业头像和头像的工具

   下载

   执行make命令进行编译。-j $(nproc)选项可以利用多核CPU加速编译过程。

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

6. 安装或复制编译后的二进制文件

   将编译好的PHP CLI二进制文件复制到您指定的位置。

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

验证DOMDocument可用性

编译完成后，您可以通过以下方法验证DOMDocument是否已成功启用：

1. 检查已加载的模块

   运行编译后的PHP二进制文件，查看已加载的模块列表：

   /path/to/your/php -m | grep dom

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

2. 执行PHP代码进行测试

   创建一个简单的PHP文件（例如test_dom.php）：

   loadXML('test');
       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明确地包含所需的扩展。