HTaccess中ErrorDocument 404无法捕获PHP文件的解决咨询

我之前也碰到过一模一样的情况，问题根源出在PHP-FPM（FastCGI）的处理逻辑上：当你访问不存在的.php文件时，Apache会直接把请求转发给PHP-FPM处理，而PHP发现文件不存在后，会直接返回自己默认的File not found.错误，完全绕过了Apache的ErrorDocument配置。

下面给你几个可行的解决方案，你可以根据自己的服务器环境选择：

方案1：用RewriteRule提前拦截不存在的PHP文件 #

这个方案不需要服务器权限，直接修改.htaccess就能生效，是最容易尝试的：

# 保留原有的404错误页配置
ErrorDocument 404 /Erreur.php?E=2

# 开启Rewrite引擎
RewriteEngine On

# 拦截所有不存在的.php文件请求
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.+\.php)$ /Erreur.php?E=2 [L,R=404]

规则逻辑很简单：如果请求的文件不是真实存在的!-f，且路径是以.php结尾的，就重定向到你的自定义错误页，同时返回标准的404状态码。

方案2：让Apache接管PHP-FPM的错误响应（适用于mod_proxy_fcgi环境） #

如果你的服务器用mod_proxy_fcgi来运行PHP-FPM，可以在.htaccess或者Apache虚拟主机配置里添加一行：

ProxyErrorOverride On

这个配置会强制让Apache的ErrorDocument覆盖PHP-FPM返回的错误页面，这样不管是静态文件还是PHP文件的404，都会统一跳转到你的自定义错误页。

方案3：调整PHP-FPM的配置（需服务器管理权限） #

如果你能修改PHP-FPM的配置文件（比如www.conf或对应站点的pool配置），可以添加/修改以下参数：

# 限制PHP仅处理指定后缀的合法文件
security.limit_extensions = .php .php7 .php8
# 开启错误捕获，将不存在文件的请求交还给Apache处理
catch_workers_output = yes

修改后记得重启PHP-FPM服务，这样PHP就不会直接返回错误，而是把不存在文件的请求交还给Apache处理，自然就会触发你的自定义404页。

建议先试试方案1，修改后直接测试访问不存在的.php文件，应该就能正常跳转到你的Erreur.php了。

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