loadmodule php5 module

第一次在 Apache 配置文件里写下 LoadModule php5_module 这行字，很多人会以为它只是“让 Apache 认识 PHP”这么简单。实际敲下去之后，服务器可能直接报错起不来，也可能一切正常，但 PHP 脚本依然被当成纯文本吐给浏览器。问题往往不在这一行本身，而在于它背后的路径、模块依赖和 Apache 的加载顺序。

这行指令的完整形态通常是这样的：

LoadModule php5_module "c:/php/php5apache2_4.dll" 

在 Linux 下则更像：

LoadModule php5_module /usr/lib/apache2/modules/libphp5.so 

关键点在于，LoadModule 后面跟的两个参数——模块名和模块文件路径——必须真实存在且匹配。模块名 php5_module 是 Apache 内部使用的标识，不能随便改。路径写错一个斜杠，或者文件根本没有编译出来，Apache 启动时就会抛出一句冷冰冰的 “Cannot load modules/libphp5.so into server”。

我见过一个典型的翻车现场：有人从 PHP 5.6 升级到 PHP 7 之后，只把 PHP 目录换了，却忘了 Apache 配置里还留着 LoadModule php5_module 指向旧的 php5apache2_4.dll。结果 Apache 服务反复重启失败，Windows 事件日志里全是模块加载错误。把这一行改成 LoadModule php7_module 并指向新的 DLL，问题立刻消失。这说明 LoadModule 不是“声明一下就行”，它是一次硬绑定。

另一个容易被忽略的细节是加载顺序。Apache 先加载核心模块，再加载依赖模块。如果 php5_module 依赖的 mpm_winnt_module 或 mpm_prefork_module 还没就位，即使路径正确，模块初始化也会失败。所以你会看到很多教程强调：把 LoadModule php5_module 放在 LoadModule mpm_*_module 之后。这不是玄学，是 Apache 的模块依赖机制在起作用。

还有一点，LoadModule php5_module 只负责把 PHP 模块挂进 Apache。它不会自动让 Apache 把 .php 文件交给 PHP 解析。你还得配合 AddType application/x-httpd-php .php 或者 SetHandler application/x-httpd-php。少了这步，Apache 加载了 PHP 模块，但访问 index.php 时依然会弹出下载对话框。很多人卡在这里，以为 LoadModule 没生效，其实是后续映射没做。

在 Linux 上用包管理器安装时，比如 apt install libapache2-mod-php5，系统会自动在 mods-available/php5.load 里写好 LoadModule php5_module /usr/lib/apache2/modules/libphp5.so，然后通过 a2enmod php5 建立软链接到 mods-enabled。手动编译 PHP 时，--with-apxs2 会生成 libphp5.so，但不会替你改 httpd.conf。你得自己把那行 LoadModule 加进去，路径写对，顺序放对。

我自己的习惯是，每次改完 LoadModule 相关配置，先跑 apachectl configtest 或 httpd -t。这个命令会检查语法和模块路径，比直接重启服务安全得多。如果输出 “Syntax OK”，再重启。如果报 “Cannot load ...”，就去确认文件是否存在、权限是否可读、架构是否匹配——32 位 Apache 配 64 位 PHP 模块，同样会加载失败。

说到底，LoadModule php5_module 这行配置像一把钥匙。钥匙本身不复杂，但插错锁孔、插反方向、或者锁芯根本没装，门都打不开。把路径、顺序、后续映射这三件事捋清楚，PHP 5 才能在 Apache 里真正跑起来。