如何解决XAMPP中Apache无法加载PHP模块的问题？

本文共计1080个文字，预计阅读时间需要5分钟。

XAMPP中的Apache无法加载PHP模块，问题并非模块未安装，而是因为httpd.conf配置中未正确关联已内置的PHP处理器。XAMPP自带PHP，但默认配置可能已被修改，或因版本冲突导致失效。

检查 XAMPP 的 php_module 是否实际启用

XAMPP 的 Apache 并不靠 LoadModule php_module 手动加载 so/dll，而是通过 Include "conf/extra/httpd-xampp.conf" 引入专用配置。如果这行被注释或删了，PHP 就彻底失联。

• 打开 C:\xampp\apache\conf\httpd.conf（Windows）或 /opt/lampp/etc/httpd.conf（Linux/macOS）
• 搜索 httpd-xampp.conf，确认该行未被注释（即前面没有 #）
• 若找不到这行，说明配置被重置过，需手动加回：Include "conf/extra/httpd-xampp.conf"
• 保存后运行 xampp-control.exe → 点击 Apache 的 “Stop” 再 “Start”，不要只点 Restart

验证 httpd-xampp.conf 是否真在处理 .php 文件

即使 httpd-xampp.conf 被引入，它内部仍需明确声明 PHP 处理器。XAMPP 6.0+ 默认用 SetHandler application/x-httpd-php，但旧版或手动改过的内容可能残留 AddType 或错误的 SetHandler。

• 打开 C:\xampp\apache\conf\extra\httpd-xampp.conf
• 查找包含 .php 的 <FilesMatch> 或 AddHandler 区块
• 确认存在类似以下内容（注意路径和 handler 名称必须匹配当前 PHP 版本）：

  <FilesMatch "\.php$"> SetHandler application/x-httpd-php </FilesMatch>

• 如果看到 AddType application/x-httpd-php .php，保留它也行，但优先以 SetHandler 为准；两者共存不冲突，但顺序错可能导致覆盖

端口占用或服务冲突导致模块“假失败”

Apache 启动日志显示 Cannot load php_module，有时根本不是模块问题，而是 Apache 根本没起来——比如 80/443 端口被 Skype、IIS、甚至另一个 XAMPP 实例占着，导致 httpd 进程异常退出，后续模块加载自然失败。

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

• 启动前先执行 netstat -ano | findstr :80（Windows）或 lsof -i :80（macOS/Linux），看 PID 是谁
• 若 PID 对应非 httpd.exe 或 apache2，杀掉它：taskkill /PID 1234 /F（Windows）或 kill -9 1234（其他系统）
• 再试启动；如果仍失败，查 C:\xampp\apache\logs\error.log，重点看第一行报错，不是最后几行
• 常见干扰项：Windows 自带的 IIS（sc query w3svc 查状态）、Docker Desktop（默认占 80/443）、甚至 Zoom（旧版会抢 8080）

多 PHP 版本共存时的路径错位

XAMPP 控制面板右下角显示的 PHP 版本（如 8.2.12），和你命令行里 php -v 输出的版本不一致，说明系统 PATH 指向了外部 PHP，而 Apache 仍用 XAMPP 自带的。这时 php.ini 加载路径容易混乱，扩展（如 extension=openssl）可能因依赖库版本不匹配而静默失败，最终表现为 PHP 页面空白或 500 错误。

• 在浏览器访问 http://localhost/dashboard/phpinfo.php，看顶部 “Loaded Configuration File” 路径是否为 C:\xampp\php\php.ini
• 如果不是，说明 Apache 没读到 XAMPP 的配置，极可能是 httpd-xampp.conf 里 PHPINIDir 设置错了，或被其他配置覆盖
• 临时验证：把 C:\xampp\php\php.ini 复制一份到桌面，改名 php.ini.bak，然后在 httpd-xampp.conf 里显式指定：PHPINIDir "C:/xampp/php"（注意正斜杠）
• 重启 Apache，再刷 phpinfo.php 确认路径是否修正

真正卡住的地方，往往不是模块加载本身，而是 Apache 启动失败后你只盯着“php_module”报错，却没看前一行的“no listening sockets”或“AH00526”。先让 Apache 跑起来，PHP 模块才有机会被加载。