PHP 8.1 的 mod_php 模块文件在 Linux 下需真实存在：Debian/Ubuntu 位于 /usr/lib/apache2/modules/libphp8.1.so，RHEL/CentOS 通常为 /usr/lib64/httpd/modules/libphp.so，macOS Homebrew 路径类似 /usr/local/Cellar/php@8.1/8.1.28/lib/httpd/modules/libphp.so。
确认 PHP 8.1 的 mod_php 模块文件是否存在
Linux 系统下，libphp.so（如 libphp8.1.so）必须真实存在且路径正确。Debian/Ubuntu 默认安装 libapache2-mod-php8.1 后，模块通常位于 /usr/lib/apache2/modules/libphp8.1.so；RHEL/CentOS 则多在 /usr/lib64/httpd/modules/libphp.so（不带版本号）。macOS 用 Homebrew 安装时路径类似 /usr/local/Cellar/php@8.1/8.1.28/lib/httpd/modules/libphp.so。
Windows 下必须使用与 Apache 编译器匹配的 php8apache2_4.dll（Apache 2.4 + VS2019/VC17），且该文件需和 php.ini 在同一目录（如 C:/php/），否则 PHPIniDir 会失效。
启用模块并绑定 .php 文件处理
Linux（Debian/Ubuntu）直接运行：a2enmod php8.1，然后 systemctl reload apache2；RHEL/CentOS 需手动编辑 /etc/httpd/conf/httpd.conf 或 /etc/httpd/conf.modules.d/15-php.conf，确保有：
LoadModule php_module modules/libphp.so AddHandler application/x-httpd-php .php AddType application/x-httpd-php .php
Windows 必须在 httpd.conf 中显式写入三行（顺序不能错）：
LoadModule php_module "C:/php/php8apache2_4.dll" AddHandler application/x-httpd-php .php PHPIniDir "C:/php"
注意：AddType 和 AddHandler 缺一不可——仅 AddHandler 不足以让 Apache 正确设置 MIME 类型，浏览器可能下载 .php 文件而非执行。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
立即学习“PHP免费学习笔记（深入）”；
验证是否真正生效，而不是“加载成功但不干活”
执行 apache2ctl -M | grep php（Linux）或 httpd -M | findstr php（Windows）只说明模块被加载，不代表 PHP 脚本能跑。必须做两件事：
- 在 DocumentRoot 下新建
test.php，内容为<?php phpinfo(); ?> - 用
curl http://localhost/test.php请求，**不能用浏览器直接双击打开文件** - 若返回纯文本或下载，检查：
<Directory>块是否含Require all granted（Apache 2.4+）；DocumentRoot路径是否拼写错误（尤其 Windows 下斜杠方向、末尾多余反斜杠）；php.ini中short_open_tag = Off时，test.php不能只写echo 'ok'; ?>，必须用<?php
常见启动失败原因：不是配置错，是依赖缺
Apache 启动报 Cannot load C:/php/php8apache2_4.dll into server: The specified module could not be found.，90% 不是路径问题，而是：
- 缺失 VC 运行库：PHP 8.1+ 需要 Visual C++ 2019 运行库（
vcruntime140.dll等），单独下载安装 Microsoft Visual C++ Redistributable for Visual Studio 2019 - Apache 和 PHP 编译器不匹配：Apache 官方二进制包用 VS2019 编译，你却用了 PHP 官网 VC15（VS2017）版 DLL，就会失败
- Windows 下
php8apache2_4.dll依赖的其他 DLL（如libssh2.dll、ssleay32.dll）没放在PATH或 Apache 的bin目录里
最稳妥的做法：用 depends.exe（Dependency Walker）打开 php8apache2_4.dll，看哪些 DLL 标红——那些就是必须补上的。
