Apache添加PHP处理程序配置教程

Apache需通过模块（如libphp或php-fpm）解析PHP，仅改AddType或DirectoryIndex无效；须确认php_module已加载、正确配置AddHandler或ProxyPassMatch、DirectoryIndex含index.php，并确保PHP-FPM socket权限正确。

Apache 本身不解析 PHP，必须通过模块（如 libphp 或 php-fpm）把请求交给 PHP 处理。直接改 AddType 或加 DirectoryIndex 不起作用——这是最常见的配置失效原因。

确认 PHP 模块是否已加载

运行 httpd -M | grep php（Linux/macOS）或 apache2ctl -M | grep php，看输出中是否有 php7_module 或 php8_module。若无，说明模块没启用，后续所有配置都无效。

• Debian/Ubuntu：检查 /etc/apache2/mods-enabled/php8.2.load 是否存在，不存在就执行 a2enmod php8.2
• RHEL/CentOS：确认 /etc/httpd/conf.modules.d/15-php.conf 已存在且未被注释
• 源码编译 Apache：需在 ./configure 时加 --enable-so，并用 LoadModule php_module modules/libphp.so 手动加载

设置 PHP 文件的处理器（AddHandler vs AddType）

AddType application/x-httpd-php .php 是过时写法，现代 Apache 推荐用 AddHandler 显式绑定处理器。仅靠 AddType 不足以触发 PHP 解析，尤其在启用了 mpm_event 的环境下。

• 在 httpd.conf 或虚拟主机配置中添加：

  AddHandler application/x-httpd-php .php .phtml

• 若使用 PHP-FPM，则应改用 ProxyPassMatch：

  ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/html/

• 注意路径结尾的 / ——PHP-FPM 的 SCRIPT_FILENAME 依赖它，漏掉会导致 “No input file specified” 错误

验证 DirectoryIndex 是否包含 PHP 入口文件

即使 PHP 能解析，访问目录时若没指定文件名，Apache 默认只找 index.html。不显式加入 index.php，就会返回 403 或直接下载源码。

• 确保配置中有：

  DirectoryIndex index.php index.html

• 该指令需放在 块内，或全局生效的主配置中；放在 .htaccess 里需允许 AllowOverride Indexes
• 若同时启用 mod_rewrite，注意重写规则可能覆盖 DirectoryIndex 行为，建议先关掉重写测试基础功能

最常被忽略的是模块加载状态和 PHP-FPM 的 socket 权限——www-data 用户必须对 /run/php/php8.2-fpm.sock 有读写权，否则 503 错误连日志都不报具体原因。