错误 & 日志

错误详情

默认情况下，应用中会默认输出错误详情。这就是说当有错误发生时，你将看到一个详细的堆栈轨迹（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 异常

有些异常用于描述来自服务器的HTTP错误码，如“页面不存在” 错误(404)、“未授权错误” (401) 以及由开发者生成的500错误等。通过下面的代码可以返回这种响应：

App::abort(404);

你还可以为响应提供一个可选参数：

App::abort(403, 'Unauthorized action.');

该方法可以在请求生命周期的任何时候调用。

处理404错误

你可以注册一个错误处理器来处理应用中的所有"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)
{
    //
});

译者：王赛（Bootstrap中文网）