PHP报错需主动暴露而非依赖白屏:开发环境开启display_errors=On、error_reporting=E_ALL、log_errors=On并配置error_log路径,重启服务生效;用error_get_last()兜底捕获致命错误,CLI模式直接输出完整报错,结合set_error_handler与register_shutdown_function实现全量错误拦截,同时确保日志可写、带时间戳和PID。

PHP 报错不能只靠浏览器白屏或空白响应来猜——关键得让错误真正“露出来”,否则连 Parse error 都看不到,更别说定位 Fatal error 或 Warning。
开启 PHP 错误显示与日志记录
默认情况下,很多生产环境会关闭 display_errors,导致错误被静默吞掉;而 error_log 若未配置,错误就无处可查。
-
display_errors = On(仅开发环境启用,切勿在生产环境打开) -
error_reporting = E_ALL(覆盖E_DEPRECATED、E_NOTICE等所有级别) -
log_errors = On(必须开启,才能写入日志) -
error_log = /var/log/php/error.log(指定绝对路径,确保 Web 服务器用户有写权限)
修改后需重启 Web 服务(如 sudo systemctl restart apache2 或 sudo systemctl restart php-fpm),否则配置不生效。
用 error_get_last() 捕获最后一条致命错误
error_get_last() 是少数能“事后”拿到刚发生的 Fatal error 的方式,适用于脚本末尾兜底检查,但无法捕获已终止执行的致命错误(比如 Call to undefined function 后脚本直接退出,后续代码不执行)。
立即学习“PHP免费学习笔记(深入)”;
if ($error = error_get_last()) {
if (in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
error_log('FATAL: ' . $error['message'] . ' in ' . $error['file'] . ':' . $error['line']);
}
}
注意:它只返回**最近一次错误**,且仅对非终止类错误(如 Warning)更可靠;Fatal error 发生后,该函数可能根本没机会运行。
在 CLI 模式下直接看到完整报错
Web 环境容易被 Nginx/Apache 层级配置掩盖错误,而 CLI 模式最干净。运行 php script.php,错误会直接输出到终端,含文件名、行号、错误类型和堆栈(如果启用了 display_errors)。
- 确保 CLI 使用的
php.ini和 Web 使用的不是同一份(可用php --ini查看) - CLI 默认
error_reporting通常是E_ALL,但display_errors可能为Off,需手动确认 - 遇到
Segmentation fault这类底层崩溃,需用php -d zend_extension=xdebug.so script.php配合调试器定位
用 set_error_handler + register_shutdown_function 组合抓取全量错误
这是最接近“全拦截”的做法:set_error_handler 捕获 Warning/Notice,register_shutdown_function 在脚本终止前检查是否发生了 Fatal error。
set_error_handler(function($errno, $errstr, $errfile, $errline) {
error_log("PHP $errno: $errstr in $errfile:$errline");
});
register_shutdown_function(function() {
if ($error = error_get_last()) {
if (in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
error_log("SHUTDOWN FATAL: {$error['message']} in {$error['file']}:{$error['line']}");
}
}
});
注意:该组合仍无法捕获 memory_limit 超限或 max_execution_time 中断这类 Zend 引擎级终止;它们不会触发 error_get_last(),需依赖 error_log 文件或系统监控。
真正难定位的从来不是报错文字本身,而是错误发生时上下文已丢失——变量值、调用链、请求参数全没了。所以别只盯着“怎么显示错误”,先确保 error_log 路径可写、日志轮转不丢数据、每条日志带时间戳和 PID,这些比花哨的前端提示管用得多。











