1. 理解PHP错误报告机制
php的错误报告机制通过error_reporting配置项来控制哪些错误类型会被报告。通常，我们希望记录所有关键错误，但可能希望忽略一些不影响程序运行的通知（e_notice）、警告（e_warning）或已弃用功能（e_deprecated）的提示，以保持错误日志的清洁和可读性。
在PHP中，error_reporting的值是一个位掩码，通过对不同的错误常量进行位运算来组合。例如，E_ALL表示所有错误，而~E_NOTICE表示排除通知。当我们需要在.htaccess文件或php.ini中设置此值时，必须提供一个整数。
2. 计算error_reporting的整数值
要在.htaccess中排除特定的错误类型，我们需要将PHP的错误常量位运算结果转换为一个具体的整数值。假设我们希望报告所有错误，但排除E_NOTICE、E_WARNING和E_DEPRECATED，其计算方式如下：
- E_ALL (报告所有错误) 的值为 32767
- E_NOTICE 的值为 8
- E_WARNING 的值为 2
- E_DEPRECATED 的值为 8192
通过位运算 E_ALL & ~E_NOTICE & ~E_WARNING & ~E_DEPRECATED，我们可以得到期望的整数值： 32767 - 8 - 2 - 8192 = 24565
因此，在.htaccess中设置error_reporting时，应使用24565。
3. .htaccess配置示例
以下是一个完整的.htaccess配置示例，用于精细控制PHP的错误报告行为：
立即学习“PHP免费学习笔记（深入）”；
# 关闭PHP启动错误显示 php_flag display_startup_errors off # 关闭PHP错误显示到浏览器 php_flag display_errors off # 关闭HTML格式的错误信息 php_flag html_errors off # 开启错误日志记录 php_flag log_errors on # 指定错误日志文件的路径 # 请确保此路径可写，且Web服务器用户拥有写入权限 php_value error_log /path/to/your/log/error_log.log # 设置错误报告级别为：E_ALL & ~E_NOTICE & ~E_WARNING & ~E_DEPRECATED (即 24565) php_value error_reporting 24565
注意事项：
- /path/to/your/log/error_log.log 必须替换为您的实际日志文件路径。
- Web服务器用户（如 www-data 或 apache）必须对指定的日志文件及其父目录拥有写入权限。
4. 故障排除：当配置不生效时
即使.htaccess配置正确，有时您可能仍然发现PHP警告被记录或显示。这通常是由于以下几个原因造成的。
4.1 验证PHP脚本内部的错误报告设置
首先，检查PHP脚本本身是否正确地设置了错误报告级别，并且您的期望值被正确解析。您可以在一个独立的PHP文件中进行测试：
运行此脚本，您应该看到var_dump输出string(5) "24565"，并且不会显示或记录E_WARNING、E_NOTICE和E_DEPRECATED类型的错误（假设display_errors为off且log_errors为on，并且日志文件可写）。如果此测试显示警告，则表明PHP环境或脚本本身在处理错误级别时存在问题。
4.2 确认.htaccess指令已被PHP解析
接下来，我们需要确认Web服务器（如Apache）是否正确读取并应用了.htaccess文件中的php_value指令。您可以通过以下PHP脚本来检查当前PHP配置：
将上述代码保存为test.php并放置在.htaccess文件所在的目录下，然后通过浏览器访问test.php。如果.htaccess设置生效，var_dump应该输出string(5) "24565"，并且E_WARNING不应被显示或记录。如果输出的值不为24565，或者警告仍然出现，可能的原因包括：
- Web服务器（如Apache）未启用AllowOverride All，导致.htaccess文件不被解析。
- .htaccess文件存在语法错误，导致其部分或全部指令未生效。
- PHP运行在CGI/FastCGI模式下，可能需要使用user.ini而不是.htaccess来配置PHP指令。
4.3 检查PHP代码是否覆盖了.htaccess设置
PHP脚本中的ini_set()函数或error_reporting()函数具有最高的优先级，它们可以覆盖.htaccess或php.ini中设置的任何错误报告级别。
仔细检查您的PHP应用程序代码，查找以下函数调用：
- ini_set('error_reporting', /* 某个值 */);
- error_reporting(/* 某个值 */);
如果您的代码中存在这些调用，并且它们将error_reporting设置为一个与.htaccess不同的值，那么代码中的设置将优先。例如，如果代码中存在error_reporting(E_ALL);，它将覆盖.htaccess中的24565，导致所有错误（包括通知和警告）都被报告。
5. 重要注意事项
- 服务器配置 (AllowOverride): 对于Apache服务器，httpd.conf或虚拟主机配置中必须设置 AllowOverride All，以便.htaccess文件中的指令能够生效。如果设置为None，.htaccess文件将被完全忽略。
- php_value 与 php_flag: php_value 用于设置字符串或数值类型的PHP配置（如error_reporting, error_log），而php_flag用于设置布尔类型的PHP配置（如display_errors, log_errors）。请确保使用正确的指令。
- 错误日志路径权限: 确保php_value error_log指定的日志文件路径存在，并且Web服务器进程（通常是www-data、apache或nginx用户）对该文件和其所在目录拥有写入权限。否则，错误将无法写入日志文件。
- display_errors 与 log_errors: 在生产环境中，强烈建议将display_errors设置为off，以避免敏感信息泄露给最终用户。同时，将log_errors设置为on，确保所有错误都被记录到日志文件中，便于后期排查。
总结
通过在.htaccess中精确配置php_value error_reporting，我们可以有效地控制PHP的错误报告行为，实现只记录关键错误，排除不重要的通知和警告。当配置不生效时，通过系统地检查PHP脚本的error_reporting值、确认.htaccess指令的生效状态以及排查PHP代码中的覆盖行为，可以帮助您快速定位并解决问题，确保您的错误日志按预期工作。
