如何在 Termux 中正确配置 Apache 以加载 PHP 模块

如何在 Termux 中正确配置 Apache 以加载 PHP 模块

在 Termux 中运行 Apache + PHP 时，因模块命名与 PHP 版本不匹配（如 PHP 8.x 实际提供 libphp.so 而非 libphp7.so），导致 httpd: Cannot load ... not found 错误，需修正 LoadModule 指令中的模块名与路径。

在 Termux 环境下搭建 Apache 与 PHP 的组合，不少朋友都卡在了启动 Apache 那一步，遇到一个经典的“找不到模块”错误。这背后的原因，其实和 Termux 独特的打包方式以及 PHP 版本演进有关。

简单来说，Termux 里的 Apache 和 PHP 集成，并没有完全照搬传统 Linux 发行版的套路。尤其是从 PHP 8.0 开始，官方已经弃用了旧的 `php7_module` 命名约定，转而使用更通用的 `php_module`。相应地，动态库文件的名字也从 `libphp7.so` 变成了 `libphp.so`。这就意味着，即使你安装的是 PHP 8.1（比如文章开头提到的 PHP 8.1.3），Termux 的包管理器（pkg）提供的 Apache PHP 模块，其文件名依然是 `libphp.so`，并且它老老实实地待在标准路径 `/data/data/com.termux/files/usr/libexec/apache2/` 里。

所以，问题的症结就很清楚了：配置文件里写的模块名和实际的文件名对不上号。解决办法就是修正 Apache 的主配置文件 `httpd.conf`。

你需要把里面那条错误的配置指令：

LoadModule php7_module /data/data/com.termux/files/usr/libexec/apache2/libphp7.so

替换成下面这样：

LoadModule php_module /data/data/com.termux/files/usr/libexec/apache2/libphp.so

改完之后，配置文件里后续关于 PHP 文件处理的配置通常不需要动，保持原样即可：

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

    SetHandler application/x-httpd-php

✅ **验证与测试步骤**：

1. 保存修改好的 `httpd.conf` 文件；
2. 执行 `apachectl configtest` 命令，确认语法无误（看到 “Syntax OK” 就对了）；
3. 启动 Apache 服务：`apachectl start`；
4. 打开浏览器，访问 `http://localhost:8080`（记住，Termux 中 Apache 的默认端口是 8080）。为了验证 PHP 是否真的工作了，可以在网站根目录下创建一个 `info.php` 文件，内容就是：

⚠️ **几个关键的注意事项**：

• 千万别手动去重命名那个 `.so` 文件（比如把 `libphp.so` 改成 `libphp7.so` 来将就旧配置），这很可能会导致符号链接解析失败，引发更隐蔽的问题。
• Termux 中 Apache 模块的存放路径是固定的，不要随意改动 `libexec` 目录的结构。
• 如果修改后仍然报错，第一步应该是确认模块文件是否真实存在。可以运行这个命令检查：

ls -l $PREFIX/libexec/apache2/libphp.so

如果文件确实不存在，那可能是安装不完整。可以尝试重新安装 PHP 的 Apache 模块：

pkg reinstall php-apache

总结一下，这个问题的本质，是 Apache 配置中引用的模块标识符（module name）与实际磁盘上的共享库文件（shared object）命名不一致导致的。Termux 遵循的是上游 Apache 和 PHP 项目现代的命名规范。因此，正确的做法是始终使用 `php_module` 配合 `libphp.so` 这个组合，而不要再沿用 PHP 7 时代的旧习惯了。