在 PHP 开发过程中，错误报告是排查问题的重要工具，通过合理设置 PHP 的错误报告级别，开发者可以快速定位代码中的问题，提升开发效率，本文将详细介绍如何配置 PHP 以显示错误信息,以及在不同环境下的最佳实践。
开启 PHP 错误报告的基本方法
PHP 提供了多种方式来控制错误报告的显示，最常用的方法是通过 php.ini 配置文件进行全局设置，在 php.ini 文件中，找到 display_errors 和 error_reporting 指令，将 display_errors 设置为 On 可以直接在浏览器中显示错误信息，而 error_reporting 则用于指定需要捕获的错误级别。error_reporting = E_ALL 会显示所有类型的错误和警告，对于开发环境，建议启用所有错误报告,以便及时发现潜在问题。
在代码中动态设置错误报告
除了修改 php.ini 文件外，还可以在 PHP 脚本中使用 ini_set() 函数动态调整错误报告设置。ini_set('display_errors', 1); 会开启当前脚本的错误显示，这种方法特别适合临时调试或在不修改配置文件的情况下快速启用错误报告，需要注意的是，ini_set() 的作用范围仅限于当前脚本及其包含的文件,因此对于大型项目可能需要更精细的控制。
区分开发环境与生产环境
在实际开发中，错误报告的设置需要根据环境进行调整，开发环境应尽可能详细地显示错误信息，以便快速修复问题；而生产环境则需要隐藏敏感的错误详情，避免暴露系统漏洞，可以通过检查 $_SERVER['SERVER_ADDR'] 与 $_SERVER['REMOTE_ADDR'] 是否一致来判断是否为本地开发环境,从而动态切换错误报告级别。
if ($_SERVER['SERVER_ADDR'] === $_SERVER['REMOTE_ADDR']) {
ini_set('display_errors', 1);
error_reporting(E_ALL);
} else {
ini_set('display_errors', 0);
error_reporting(0);
}
处理致命错误与语法错误
PHP 的致命错误（如语法错误）通常会导致脚本中断，无法通过 set_error_handler() 捕获，这类错误需要通过 display_startup_errors 和 log_errors 指令来处理，在 php.ini 中设置 display_startup_errors = On 可以显示 PHP 启动时的错误，而 log_errors = On 则会将错误记录到指定文件中，结合 error_log 指定日志路径,可以方便地排查生产环境中的问题。
使用错误日志进行调试
即使不在浏览器中显示错误，将错误信息记录到日志文件也是调试的重要手段，在 php.ini 中设置 error_log = /var/log/php_errors.log 后，所有错误都会被写入指定文件，可以通过 error_log() 函数手动记录自定义信息，
error_log("调试信息：" . $variable);
日志文件的大小和轮转策略也需要定期维护,避免占用过多磁盘空间。
常见错误级别及其含义
PHP 的错误报告级别通过位掩码实现，常见的级别包括 E_ERROR（致命错误）、E_WARNING（运行时警告）、E_NOTICE（运行时通知）等，使用 E_ALL 可以捕获所有错误，但可能包含一些无害的通知信息，在实际应用中，可以根据需要组合多个级别，error_reporting(E_ALL & ~E_NOTICE) 会排除通知级别的错误。
相关问答 FAQs
问：为什么我的 PHP 脚本中设置了 display_errors = On 却看不到错误信息？
答：除了检查 php.ini 中的 display_errors 设置外，还需确认是否启用了 output_buffering。output_buffering 开启，错误信息可能被缓冲区拦截，可以通过在脚本开头添加 ob_end_clean(); 来禁用输出缓冲，或者设置 output_buffering = Off。
问：如何在生产环境中安全地记录错误信息？
答：在生产环境中，应关闭浏览器错误显示（display_errors = Off），并启用错误日志记录（log_errors = On），建议使用 error_reporting 设置为 E_ALL & ~E_DEPRECATED & ~E_STRICT，避免记录过时的警告信息，定期检查和清理日志文件,确保敏感信息不会被泄露。