Apache启用PHP模块有两种方式：mod_php（libphp.so）或proxy_fcgi+php-fpm；前者需检查httpd -M | grep php并手动加载，后者需配置ProxyPassMatch且启动php-fpm服务。
确认 Apache 是否已启用 libphp 模块（Linux / macOS）
现代 Apache（2.4+）在多数 Linux 发行版中默认不自带 PHP 模块，需手动加载。先检查模块是否已存在：
httpd -M | grep php # 或 apachectl -M | grep php
若无输出，说明 libphp.so 未加载；若有 php7_module 或 php8_module，则已启用，但需确认版本匹配。
- Debian/Ubuntu 系统通常用
libapache2-mod-php包，启用靠a2enmod php8.2（版本号需与实际安装一致） - RHEL/CentOS 8+ 使用
dnf install php-fpm httpd后，默认走proxy_fcgi+php-fpm，不依赖libphp.so - 直接编译 Apache 的用户，必须在
./configure时加--enable-so，且 PHP 编译时带--with-apxs2=/path/to/apxs
修改 httpd.conf 手动加载 PHP 模块（Windows / 自编译环境）
Windows 下 Apache 官方二进制包不含 PHP 模块，需自行配置。关键三步：放对文件、写对路径、加对指令。
-
php8apache2_4.dll（对应 Apache 2.4）必须放在 PHP 安装目录下，且与php.ini同级 - 在
httpd.conf中添加（路径按实际调整）：
LoadModule php_module "C:/php/php8apache2_4.dll" AddHandler application/x-httpd-php .php PHPIniDir "C:/php"
注意：PHPIniDir 必须指向含 php.ini 的目录，否则 phpinfo() 显示“Loaded Configuration File”为空。
立即学习“PHP免费学习笔记（深入）”；
- Apache 启动失败常见报错：
Cannot load C:/php/php8apache2_4.dll into server: The specified module could not be found.—— 多半是php8apache2_4.dll依赖的VC14/VC17运行库未安装，或 PHP 版本与 Apache 编译器不匹配（如 Apache 用 VS2019 编译，PHP 却用 VS2015）
验证 PHP 模块是否真正生效
光有 LoadModule 不代表 PHP 脚本能执行。必须确保请求被正确路由到 PHP 处理器。
- 在
httpd.conf或虚拟主机配置中，确认有AddType application/x-httpd-php .php或AddHandler指令 - 检查
<Directory>块是否允许ExecCGI或AllowOverride All，否则.htaccess中的 PHP 配置可能被忽略 - 新建
test.php放入 DocumentRoot，内容为<?php phpinfo(); ?>，用curl http://localhost/test.php测试 —— 若返回 HTML 页面且含 PHP 版本信息，说明模块加载成功；若下载文件或显示源码，说明 MIME 类型未绑定
特别注意：DirectoryIndex 若未包含 index.php，访问根路径会 403 或列目录，不是模块问题，但常被误判。
Apache + PHP 集成的两个现实选择：mod_php vs php-fpm
所谓“集成”，现在其实只有两种稳定路径：mod_php（即 libphp.so）和 proxy_fcgi + php-fpm。前者简单但进程耦合高，后者解耦、安全、支持多 PHP 版本共存。
-
mod_php：只适合开发机或低流量场景；Apache 每个 worker 进程都载入 PHP 解释器，内存占用高；无法热更 PHP 配置，改完要重启 Apache -
php-fpm：需启动php-fpm服务，再在 Apache 中配置ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/html/；php-fpm可独立重启，支持慢日志、动态子进程管理 - Ubuntu 22.04+ 默认禁用
mod_php，a2enmod php8.1实际启用的是proxy_fcgi+php8.1-fpm，不是传统libphp
别在没搞清底层机制的情况下强行“集成”——mod_php 在容器或 systemd 环境里越来越难配，而 php-fpm 的 fcgi:// 路径拼写错误、socket 权限不对、SELinux 限制，才是真正在生产环境卡住人的地方。
