Apache2.4 .htaccess中!IfModule指令执行异常问题咨询

看起来你遇到的核心问题是：当使用!mod_php5.c的模块匹配条件时，即使mod_php5已激活，请求仍被拒绝，且自定义403错误页不生效；但去掉!后，错误页正常工作，却违背了你的预期逻辑（本应在mod_php5未激活时拒绝访问）。下面是具体的排查思路和解决方案：

一、先确认mod_php5的正确模块标识 #

很多人容易在这里踩坑：<IfModule>指令支持两种写法——模块文件名（比如mod_php5.c）或模块内部名称（比如php5_module），但不同环境下这两个名称可能不一致。

你可以通过执行服务器指令来确认：

# Apache 2.x（Debian/Ubuntu等系统）
apache2ctl -M
# Apache（CentOS/RHEL等系统）
httpd -M

在输出中找到PHP相关模块，比如可能显示为php5_module (shared)，这时候你的条件应该写成<IfModule !php5_module>而不是<IfModule !mod_php5.c>。如果模块文件名确实是mod_php5.c，那跳过这一步，但优先推荐用模块内部名称，兼容性更好。

二、排查ErrorDocument未生效的原因 #

当带!的条件导致请求被拒绝时，ErrorDocument不生效，大概率是以下两种情况：

1. 指令优先级/作用域问题：如果你的Require all denied指令在某个嵌套块（比如<Directory>或<Files>）中，而ErrorDocument写在外面，可能被块内的拒绝逻辑直接中断，未触发全局的错误页配置。建议把ErrorDocument放在.htaccess的最顶部，或者嵌套在<IfModule>块内：

   <IfModule !php5_module>
       Require all denied
       ErrorDocument 403 /custom-403.html
   </IfModule>
   

2. 错误页路径不正确：确保/custom-403.html是相对于网站根目录（DocumentRoot）的路径，且文件存在、权限正确（Apache用户能读取）。可以直接访问这个路径测试是否能正常打开。

三、调试模块匹配逻辑是否正确 #

有时候模块匹配看似没问题，但实际条件判断反了。你可以临时添加一个测试头来验证：

<IfModule !php5_module>
    Header set X-PHP-Status "Disabled"
    Require all denied
</IfModule>
<IfModule php5_module>
    Header set X-PHP-Status "Enabled"
</IfModule>

然后用curl -I https://your-domain.com查看响应头，如果mod_php5已激活但返回了X-PHP-Status: Disabled，说明模块匹配条件写错了，回到第一步重新确认模块名。

四、排查Apache版本或配置冲突 #

如果是较旧的Apache版本（比如2.2及以前），Require all denied是Apache 2.4的语法，2.2版本应该用Deny from all。如果你的服务器是2.2，替换指令后再测试：

<IfModule !php5_module>
    Deny from all
    ErrorDocument 403 /custom-403.html
</IfModule>

另外，检查是否有其他.htaccess文件或主配置文件中的指令（比如AllowOverride设置）覆盖了当前的规则，确保AllowOverride All（或至少包含AuthConfig和FileInfo）在当前目录的配置中生效。

内容的提问来源于stack exchange，提问作者argon