如果您是PHP老手,当然知道当PHP脚本出错时发生了什么事情。此时PHP解析器将在屏幕上给出错误信息,如 Fatal error: Call to undefined function on line 19 --,因此程序在此处终止。这个信息会吓到客户,他可能立即打电话和你进行咨询。
幸运的是,这里有解决办法。PHP拥有内置工具,可以让开发人员捕捉脚本错误然后将它们转到自定义的错误处理器。此时则可以对处理器进行编程显示更多关于错误的详细信息。还可以将错误写入文件或数据库以采取补救措施。有时候还可以对处理器编写程序忽略错误消息。
本文中,我将阐述如何使用PHP的错误处理API构建用户自定义的错误处理器,并且说明如何以简单而友好的方式显示和管理脚本的错误信息。
错误类型和报告级别
我们从最基本的开始。PHP有三种最基本的错误类型,从低级到高级分别为:注意、警告和错误(或致命错误)。通常情况下,注意和警告不会终止程序; 但是致命错误则是危险故障(例如,调用一个没有定义的函数或参考一个不存在的对象),将导致程序中断。这些错误有可能在启动、解析、编译或运行时发生。
关键字如E_NOTICE, E_ERROR等用于表明错误的不同类型和等级。在PHP手册上可以获得它们的详细信息列表。
脚本阶段错误显示由error_reporting()函数进行控制。这一函数针对不同的错误等级设置不同的参数。表A给出了使用此函数报告警告和致命错误的脚本程序。
表A
<?php
// display warnings and errors
error_reporting(E_WARNING | E_ERROR);
// this will generate a notice, which will never be displayed
echo $undefinedVar;
// this will generate a fatal error, which will be displayed
callUndefFunc();
?>
将表B中的代码与上面的进行比较发现,Listing B中隐藏错误信息甚至隐藏致命信息,使得错误信息不会被显示出来。
表B
<?php
// turn off error display
// no errors will be displayed
error_reporting(0);
// this will generate a notice
echo $undefinedVar;
// this will generate a fatal error
callUndefFunc();
?>
表C中的代码将所有错误信息甚至简单的注意事项都显示出来:
表C
<?php
// all errors will be displayed
error_reporting(E_ALL);
// this will generate a notice
echo $undefinedVar;
// this will generate a fatal error
callUndefFunc();
?>
如以上3个例子所示,error_reporting()函数在控制错误发生时,在屏幕上显示内容非常重要。这里的关键字是displayed,其表达的意思是错误不被显示而不是错误没有发生。因此,发生致命错误时(例如不正确的函数调用),程序将被终止;但是,此时没有任何消息显示给用户。
下面的例子(表 D)说明了这种情况:
表D
<?php
// no errors will be displayed
error_reporting(0);
// start a task
echo "Starting task...";
// call an undefined function
// a fatal error occurs during task processing
callMe();
// end the task
echo "Successfully completed task...";
?>
在表D中,在调用echo()函数时发生了致命错误,程序执行时到这点被终止,但是却没有任何错误消息给出,用户不知道这种情况还以为程序在正确运行。下面的结论是非常明显的:不给出错误报告非常危险,因为不论过程是否完成它常导致不正确的结论。
注意:调用不带任何参数的error_reporting()将返回当前的错误报告等级。
自定义错误处理器
很明显,隐藏错误报告是不正确的,你肯定想知道有什么其他办法加以改进。自定义错误处理器就是一个很好的能取代PHP默认错误处理系统的解决方法。自定义错误处理器可以以任何方式设置处理错误信息,包括信息如何显示。
PHP函数中,完成这一功能的是set_error_handler()函数。错误发生时,此函数被自动调用,然后给出4个参数:错误代码、错误消息、发生错误的脚本名称和错误出现的行,此函数对错误管理负责。
表E给出一个简单例子:
表E
<?php
// define custom handler
set_error_handler('myHandler');
// custom handler code
function myHandler($code, $msg, $file, $line) {
echo "Just so you know, something went wrong at line $line of your script $file. The system says that the error code was $code, and the reason for the error was: $msg. Sorry about this!";
}
// generate a notice
echo $undefVar;
?>
当运行此脚本的时候,会出现下面的信息:
Just so you know, something went wrong at line 11 of your /dev/error1.php. The system says that the error code was 8, and the reason for the error was: Undefined variable: undefVar. Sorry about this!
此时,PHP的默认错误处理器被用户定义的myHandler()函数所取代,$undefVar变量被激活,PHP通知未定义变量的信息,此信息在运行时引擎产生,然后传递给myHandler()函数,同时错误发生的地址也传递给此函数。然后myHandler()函数输出友好信息解释错误。
注意:错误和致命错误很重要,它们会绕过自定义错误处理器,然后以PHP默认的错误处理机制进行显示。显示这些信息可使用前面讨论的标准error_reporting()函数进行控制。
例1:动态错误页面和e-mail警报
表F给出了另一个范例,当发生错误时,将动态产生HTML错误页面,并且通过e-mail向Web管理员进行报告。
表F
<?php
// define custom handler
set_error_handler('myHandler');
// custom handler code
function myHandler($code, $msg, $file, $line, $context) {
// print error page
echo "<html><head></head><body>";
echo "<h2 align=center>Error!</h2>";
echo "<font color=red size=+1>";
echo "An error occurred while processing your request. Please visit our <a href=http://www.domain.dom>home page</a> and try again.";
echo "</font>";
echo "</body></html>";
// email error to admin
$body = "$msg at $file ($line), timed at " . date ("d-M-Y h:i:s", mktime());
$body .= "nn" . print_r($context, TRUE);
mail ("webmaster@domain.dom", "Web site error", $body);
// halt execution of script
die();
}
// generate a notice
echo $undefVar;
?>
这里,自定义的错误处理器在遇到错误时动态产生HTML错误页面。此错误信息也能被e-mail信息捕获,然后通过PHP内置的mail()函数发送给管理员。
这里出现了myHandler()函数的一个新参数$context。这是myHandler()函数的第五个参数,是可选项。它包含了当前变量状态的快照。包括对管理员有用的上下文信息,有利于减少调试时间。
例2:自定义错误日志
表G给出了另一个例子,这个例子说明自定义错误处理器如何将详细的错误信息输入到文件。
表G
<?php
// define custom handler
set_error_handler('myHandler');
// custom handler code
function myHandler($code, $msg, $file, $line) {
// print error page
echo "<html><head></head><body>";
echo "<h2 align=center>Error!</h2>";
echo "<font color=red size=+1>";
echo "An error occurred while processing your request. Please visit our <a href=http://www.domain.dom>home page</a> and try again.";
echo "</font>";
echo "</body></html>";
// log error to file, with context
$logData = date("d-M-Y h:i:s", mktime()) . ", $code, $msg, $line, $filen";
file_put_contents("web.log", $logData, FILE_APPEND);
// halt execution of script
die();
}
// generate a warning
echo is_float();
?>
与前面的例子相似,它也产生一个错误页面并且将错误数据输入到文件,以利于管理员进行查看。数据以CSV格式进行存储,并且有简单的数据分析和报告。请注意在本例和前面实例中,错误处理代码结束时调用die()函数,以确保脚本不再运行。
如上面的范例所示,自定义错误处理器允许以友好的方式处理PHP脚本错误。并且可以发挥自己的创造性,不过需要记住的是:任何灵活性的增加都伴随着开销和时间的增加。
相关推荐
通过本文所述的PHP自定义错误处理实例,开发者可以了解到如何利用自定义错误处理函数来增强PHP程序的健壮性和用户体验。在实际开发过程中,合理的错误处理策略能够帮助开发者及时发现并修正错误,提高代码的可维护性...
PHP Error 库解决了这个问题,它通过自定义错误处理器和异常处理机制,提供了更丰富的错误上下文信息,包括错误类型、错误位置、相关代码片段等。 集成PHP Error库非常简单,只需在项目中引入并配置即可。它支持在...
2. **系统不再处理错误**:一旦设置了自定义错误处理器,PHP将不再使用默认的错误处理机制,除非你显式地恢复。这意味着你需要在自定义函数中处理所有可能的错误类型。 为了更全面地管理错误,可以结合使用`set_...
Whoops还可以自定义错误页的样式和行为,例如添加自定义处理器或者过滤某些敏感信息。 **Whoops的特性** 1. **友好的错误界面**:Whoops的错误页面设计简洁,易于阅读,能快速引导开发者找到问题的根源。 2. **堆栈...
这说明了即使PHP自带的序列化和反序列化函数在出错时无法直接获取具体的错误信息,我们依然可以通过自定义错误处理器来捕获异常并进行相应处理。 文章还讨论了PHP中现有的异常处理机制的不足之处,比如json_decode...
异常处理提供了一种更加有序的方式来处理错误,它使得程序更加健壮,允许开发者在遇到问题时优雅地进行错误处理,而不是让程序崩溃。在实际开发中,尤其是在处理可能出错的操作(如数据库查询、文件操作等)时,广泛...
`set_error_handler` 允许我们创建一个自定义的函数来处理错误,而不是使用默认的错误处理方式。例如: ```php function customErrorHandler($errno, $errstr, $errfile, $errline) { // 记录错误到日志文件 ...
在PHP编程中,`include`、`require`和`require_once`是三个常见的语句,用于将一个或多个文件的内容合并到当前脚本中。...最后,良好的错误处理机制,如自定义错误处理器,可以帮助你在出现问题时提供更具体的反馈。
4. **自定义配置**:开发者可以根据项目需求自定义 Whoops 的显示风格和行为,比如添加自定义错误信息或过滤敏感数据。 **在 Laravel 中集成 Whoops** 在 Laravel 4.x 版本中,Whoops 已经被集成到了框架内,但...
这个自定义处理器接收四个参数:错误级别、错误消息、错误发生的文件名和行号。`register_shutdown_function`注册了`fatalErrorHandler`函数,使其在脚本结束时运行,特别是处理致命错误。 `errorHandler`函数内部...
在PHP编程中,异常处理是一种重要的错误管理机制,它允许程序员优雅地处理可能出现的问题,而不是让程序突然崩溃。本文将详细解析PHP中的异常处理及其在给定代码中的应用。 首先,异常是程序运行时遇到的非正常情况...
PHP提供了错误报告机制和异常处理机制,可以使用`try-catch`结构捕获和处理异常: ```php try { throw new Exception("出错了!"); } catch (Exception $e) { echo "发生错误:" . $e->getMessage(); } ``` ### ...
在工作原理上,当错误发生时,`laravel-error-snapshot` 会触发一个自定义的错误处理器,该处理器捕获异常并生成一个包含所有相关数据的快照。这些信息被整理并保存到日志文件或者发送到指定的日志服务(如Sentry、...
5. **错误与异常处理**:学习如何捕获和处理运行时错误,以及利用异常处理机制来优雅地处理程序出错情况。 6. **文件操作**:PHP提供了一系列文件操作函数,如打开、读取、写入和关闭文件,这对于处理用户上传、...
9. **错误处理和日志记录**:确保在程序出错时能提供有用的信息,便于调试和问题排查。 了解和掌握这些知识点,将有助于用户理解和修改这个基于PHP的水果蔬菜网站模板,创建出符合他们业务需求的在线平台。
echo "错误信息:".$e->getMessage(); } ``` ### 9. 类与对象 PHP支持面向对象编程,包括类定义、对象实例化、继承、封装和多态。以下是一个简单的类示例: ```php class Person { public $name; function _...
总结来说,这段代码展示了如何在PHP中设置时区,以及如何使用自定义函数记录日志和处理错误。这对于开发健壮的PHP应用程序是必不可少的,特别是在需要处理时间敏感的数据或需要进行详细运行时追踪的场景中。同时,...
日志的配置位于`config/logging.php`文件中,你可以在这里指定日志驱动(如`daily`、`single`等),设置存储路径,甚至自定义处理器。 在API开发中,日志记录非常关键,因为它可以帮助开发者追踪和调试错误。在...
`Perpendicular` 提供了丰富的错误处理,可以自定义错误处理器来捕获和处理异常: ```php $perpendicular->setErrorHandler(function ($error) { // 记录错误日志 error_log($error->getMessage()); }); try { ...