Apache加载php_module失败主因是libphp.so缺失、路径错误或MPM不兼容；需确认启用--with-apxs2、路径匹配、依赖库完整、模块名正确（php_module非php5_module）、MPM为prefork，并配置AddType和DirectoryIndex。
Apache 加载 php_module 失败：检查 libphp.so 是否存在且路径正确
常见错误是 Apache 启动时提示 Cannot load modules/libphp.so into server，本质是模块文件缺失或路径不匹配。PHP 编译安装后，libphp.so 默认在 libs/ 目录下（如 /usr/local/php/libs/libphp.so），但 Apache 的 httpd.conf 里写的可能是旧路径或硬编码路径。
- 先确认 PHP 安装时是否启用了
--enable-libxml和--with-apxs2（关键！没加--with-apxs2就不会生成libphp.so） - 运行
apxs -q LIBEXECDIR查看 Apache 模块默认存放路径，把libphp.so复制过去，或直接在LoadModule行中写绝对路径 - 确保
libphp.so依赖的库可访问：ldd /path/to/libphp.so | grep "not found"，缺libxml2、libsqlite3等都会导致加载失败
httpd.conf 中必须启用 AddType 和 DirectoryIndex 才能解析 .php 文件
即使 libphp.so 加载成功，访问 index.php 仍可能被直接下载或 403——这是 MIME 类型和目录索引没配对。Apache 不会自动把 .php 当作可执行脚本处理。
- 在
httpd.conf或虚拟主机配置里添加：AddType application/x-httpd-php .php<br>AddType application/x-httpd-php-source .phps
- 确保
DirectoryIndex包含index.php：DirectoryIndex index.html index.php
- 如果用了
<filesmatch></filesmatch>或安全模块（如mod_security），要确认没拦截*.php请求；部分发行版默认禁用 PHP 处理，需显式开启
PHP 8+ 与 Apache 2.4 兼容性问题：避免使用已废弃的 php5_module
老教程常写 LoadModule php5_module modules/libphp5.so，但在 PHP 7.0+ 中这个模块名已统一为 php_module，且 Apache 2.4 要求模块名严格匹配。写错名字会导致 Invalid command 'php_value', perhaps misspelled or defined by a module not included in the server configuration 这类报错。
- 检查
httpd -M | grep php输出是否为php_module (shared)，不是php5_module或php7_module -
php_value、php_flag指令只在<ifmodule php_module></ifmodule>块内有效，且不能出现在.htaccess中（除非AllowOverride Options=ExecCGI,IncludesNoExec,Indexes,Limit,MultiViews,Options,FileInfo显式放行） - PHP-FPM 模式下这些指令完全无效，此时应改用
php_admin_value配置池级参数
验证是否真走模块模式：别被 phpinfo() 里的 Server API 蒙蔽
phpinfo() 显示 Server API: Apache 2.0 Handler 是模块模式的标志，但某些打包版本（如 Ubuntu 的 libapache2-mod-php）实际用的是 prefork + mod_php，而 event MPM 下模块模式根本不可用——会直接崩溃。
立即学习“PHP免费学习笔记（深入）”；
- 运行
httpd -V | grep MPM或apache2ctl -V | grep MPM，确认当前是prefork（唯一支持mod_php的 MPM） - 若用
event或worker，必须切到 PHP-FPM +mod_proxy_fcgi，强行加载libphp.so会导致 Apache 启动失败或请求 hang 住 - 一个简单验证：修改
php.ini中display_errors = On，重启 Apache 后访问一个语法错误的 PHP 文件，如果看到错误提示说明模块链路通；如果 500 且 error_log 里只有Segmentation fault，大概率是 MPM 不兼容
httpd -t、httpd -M 和 error_log 三者交叉印证。 
