默认情况下,应用中会默认输出错误详情。这就是说当有错误发生时,你将看到一个详细的堆栈轨迹(stack trace)和错误信息页面。你可以在app/config/app.php
文件中将debug
配置选项设为false
来关闭它。
注意: 强烈建议在生产环境中关闭错误详情。
默认情况下,app/start/global.php
文件中包含了一个用于处理所有异常的处理器:
App::error(function(Exception $exception)
{
Log::error($exception);
});
这是一个最基本错误处理器。当然,你也可以自己定义更多的错误处理器。框架会根据你在定义错误处理器时指定的异常类型(type-hint)来分别调用。例如,你定义一个仅处理RuntimeException
异常的处理器:
App::error(function(RuntimeException $exception)
{
// Handle the exception...
});
如果异常处理器返回一个response,此response将会发送给浏览器,其他异常处理器将不会再被调用:
App::error(function(InvalidUserException $exception)
{
Log::error($exception);
return 'Sorry! Something is wrong with this account!';
});
若要监听PHP中的致命错误(fatal error),可以使用App::fatal
方法:
App::fatal(function($exception)
{
//
});
如果同时有多个异常处理器,应该先定义最通用的,然后定义最具体的异常处理器。例如,处理所有 Exception
类型的异常处理器应当在处理 Illuminate\Encryption\DecryptException
类型的异常处理器之前。
Laravel框架没有限定在某个“默认”的位置定义错误处理器,而是交给你自由处理。比如可以选择在 start/global.php
文件中定义错误处理器。这个文件通常用于存放“启动”过程的代码。如果这个文件过于庞大,你可以创建一个 app/errors.php
文件,并在 start/global.php
脚本中 require
该文件。另一个可选的途径是创建一个
服务提供器 来定义错误处理器。总之,对于该问题没有“正确”的答案,取决于你的偏好。
有些异常用于描述来自服务器的HTTP错误码,如“页面不存在” 错误(404)、“未授权错误” (401) 以及由开发者生成的500错误等。通过下面的代码可以返回这种响应:
App::abort(404);
你还可以为响应提供一个可选参数:
App::abort(403, 'Unauthorized action.');
该方法可以在请求生命周期的任何时候调用。
你可以注册一个错误处理器来处理应用中的所有"404 Not Found"错误,这样就可以更早的返回一个自定义的404错误页面:
App::missing(function($exception)
{
return Response::view('errors.missing', array(), 404);
});
Laravel日志工具构建在强大的Monolog库之上,并提供了一层简单的抽象层。默认情况下,Laravel为应用创建一个单独的日志文件,此文件的路径是app/storage/laravel.log
。你可以通过如下方法输出log:
Log::info('This is some useful information.');
Log::warning('Something could be going wrong.');
Log::error('Something is really going wrong.');
日志工具提供了7个日志级别,参见RFC 5424:debug、info、notice、warning、error、critical 和 alert。
还可以像Log方法传递一个包含额外数据的数组:
Log::info('Log message', array('context' => 'Other helpful information'));
Monolog提供了多种处理日志的功能。如果需要,你可以通过如下方法获取Laravel内部所使用的Monolog实例:
$monolog = Log::getMonolog();
你还可以注册一个事件,用以获取所有传输到日志的信息:
注册一个日志监听器
Log::listen(function($level, $message, $context)
{
//
});