通过.htaccess设置PHP error_reporting排除指定错误不生效问题

• PHP版本差异导致硬编码的错误级别数值失效
  E_ALL的数值不是固定值，不同PHP版本会新增错误类型导致数值变化：PHP 5.3版本E_ALL为30719，PHP 5.4~5.6为32767，PHP 7+及后续版本又新增了额外错误位，你基于32767计算出来的24565仅匹配特定版本的过滤规则，其他版本下会保留E_WARNING的错误位，自然会收到警告日志。
• PHP运行模式不支持.htaccess的PHP配置项
  php_flag、php_value配置仅在PHP作为Apache模块运行时生效，如果你的环境使用PHP-FPM/FastCGI模式运行，.htaccess中的这部分配置完全不会生效，错误级别会沿用php.ini或FPM配置的规则。
• 配置被更高优先级的设置覆盖
  1. Apache的httpd.conf或虚拟主机配置中AllowOverride参数未开启，导致.htaccess文件本身不生效
  2. 项目PHP代码中存在error_reporting()或ini_set('error_reporting', xxx)的动态调用，代码内配置优先级高于.htaccess，会覆盖你的配置
  3. 目录下存在.user.ini配置文件，其中的错误级别配置覆盖了.htaccess的设置

修复步骤 #

• 优先替换硬编码数值，直接用常量表达式配置（Apache模块模式下支持）：

php_flag display_startup_errors off
php_flag display_errors off
php_flag html_errors off
php_flag log_errors on
php_value error_log /path/log/error_log.log
php_value error_reporting E_ALL & ~E_NOTICE & ~E_WARNING & ~E_DEPRECATED

• 验证配置生效状态：
  创建info.php写入<?php phpinfo(); ?>，访问后查看error_reporting的Local Value是否符合预期，确认配置是否生效。
• 适配PHP-FPM运行模式：
  如果确认是PHP-FPM模式，删除.htaccess中的PHP配置项，在项目根目录新建.user.ini文件写入以下配置：

display_startup_errors = Off
display_errors = Off
html_errors = Off
log_errors = On
error_log = /path/log/error_log.log
error_reporting = E_ALL & ~E_NOTICE & ~E_WARNING & ~E_DEPRECATED

• 排查项目代码中的动态错误级别配置，删除或修改为符合预期的规则。

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