php laravel日志报错,Laravel 文档阅读：错误 & 日志记录
简介
Laravel 项目里已经为你配置好了错误和异常处理。项目中的异常都是在 App\Exceptions\Handler 类中处理并渲染给用户的。接下来，我们将深入到该类中进行讲解。
Laravel 是利用了 Monolog 这个库记录日志的，这个库里包含了大量的日志处理方法。Laravel 为你配置了这些处理方法，提供了单个日志文件、每日一个日志文件和将错误信息写入系统日志这几个选项供你选择。
配置
错误内容
config/app.php 配置文件中的 debug 选项决定错误发生时，显示给用户看的内容是多啊还是少，是详细啊还是简略。默认，这个选项值优先使用 .env 文件里 APP_DEBUG 字段的设定值。
对于本地开发环境，把 APP_DEBUG 设定为 true，而在生产环境，应该总是设置为 false。如果在生产环境开启了 Debug 模式，项目中的一些敏感信息就会暴露给终端用户的，后果可能不堪设想。
日志存储
Laravel 开箱支持以下几种日志记录设定：single、daily、syslog 和 errorlog。修改 config/app.php 配置文件中的 log 选项即可使用你想要的日志存储模式。例如，我们不希望日志都记录在一个文件里，而是一天的日志单独放在一个文件里，那么把 log 设定为 daily 即可：
'log' => 'daily'
设定日志文件的最大数量
使用 daily 日志模式时，默认 Laravel 只会保存最近 5 日的日志文件。如果要调整，要在 config/app.php 再添加个 log_max_files 字段指定即可：
'log_max_files' => 30
日志安全级别
Laravel 日志管理使用的是 Monolog 这个 PHP 日志库，Laravel 的 日志安全级别就是指 Monolog 所能支持的日志安全级别。由 config/app.php 的 log_level 字段值决定，默认是 debug。
Monolog 日志安全级别从低到高分别是：debug、info、notice、warning、error、critical、alert 和 emergency。
安全级别设定好后，Laravel 会记录包括当前级别在内、所有更高级别的日志类型。就是说，当你设定 log_level 的值为 error 的时候，被记录的消息范围包括：error、critical、alert 和 emergency。
'log_level' => env('APP_LOG_LEVEL', 'error'),
自定义 Monolog 配置
如果你想完全掌控 Monolog 在 Laravel 中的配置，可以使用 $app 的 configureMonologUsing 方法，这个方法是在 bootstrap/app.php 中返回 $app 之前调用。
$app->configureMonologUsing(function ($monolog) {
$monolog->pushHandler(...);
});
return $app;
自定义频道名
默认，Monolog 初始化采用的名称与当前环境一致，比如 production 或者 local。如果需要自定义，要在 config/app.php 添加一个 log_channel 选项。
'log_channel' => env('APP_LOG_CHANNEL', 'my-app-name'),
异常处理程序
report 方法
所有异常都是由 App\Exceptions\Handler 类处理的，这个类中包含两个方法：report 和 render，我们将分别介绍。report 方法用来记录异常，或者将异常日志发送给像 Bugsnnag、Sentry 这样的第三方服务。默认，report 方法会简单地把异常直接传递给基类，让基类处理记录日志的操作。当然，记录日志的方式你也可以自在设定。
例如，我们使用 PHP instanceof 比较操作符，根据异常实例的类型记录异常。
/**
* Report or log an exception.
*
* This is a great spot to send exceptions to Sentry, Bugsnag, etc.
*
* @param \Exception $exception
* @return void
*/
public function report(Exception $exception)
{
if ($exception instanceof CustomException) {
//
}
return parent::report($exception);
}
report 辅助函数
有时，需要在报告异常的同时接着出来当前的请求，全局 report 辅助函数就是做这个的，它在报告异常的时候，不会产生异常页面。
public function isValid($value)
{
try {
// Validate the value...
} catch (Exception $e) {
report($e);
return false;
}
}
忽略的异常类型
异常处理器中的 dontReport 数组属性，用来设定不被处理的异常类型。例如，例如，404 错误导致的异常以及其他几个类型的错误不会写入日志文件。
/**
* A list of the exception types that should not be reported.
*
* @var array
*/
protected $dontReport = [
\Illuminate\Auth\AuthenticationException::class,
\Illuminate\Auth\Access\AuthorizationException::class,
\Symfony\Component\HttpKernel\Exception\HttpException::class,
\Illuminate\Database\Eloquent\ModelNotFoundException::class,
\Illuminate\Validation\ValidationException::class,
];
render 方法
render 方法负责将一个异常转换为发送给浏览器的 HTTP 响应。默认传递给基类的异常都会被处理成一个响应，你或者可以根据异常类型类自定义异常响应界面。
/**
* Render an exception into an HTTP response.
*
* @param \Illuminate\Http\Request $request
* @param \Exception $exception
* @return \Illuminate\Http\Response
*/
public function render($request, Exception $exception)
{
if ($exception instanceof CustomException) {
return response()->view('errors.custom', [], 500);
}
return parent::render($request, $exception);
}
拥有 report 和 render 方法的异常类
如果异常类中包含了 report 和 render，这就避免了我们在 Handler 类中检查异常类型，然后 report 和 render 异常带来的麻烦。这两个方法会在异常发生时，自动被框架调用：
namespace App\Exceptions;
use Exception;
class RenderException extends Exception
{
/**
* Report the exception.
*
* @return void
*/
public function report()
{
//
}
/**
* Render the exception into an HTTP response.
*
* @param \Illuminate\Http\Request
* @return \Illuminate\Http\Response
*/
public function render($request)
{
return response(...);
}
}
HTTP 异常
你可以使用全局辅助函数 abort 直接在程序里抛出异常，比如「页面未找到」的 404 错误，「未认证」 的 401 错误，甚至是 500 「程序内部错误」。
abort(404);
abort 抛出的异常会立即被 Handler 处理，渲染成错误页面。你也可以使用第二个可选参数，设置响应文本。
abort(403, 'Unauthorized action.');
自定义 HTTP 错误页面
根据 HTTP 状态码来显示对应的错误页面，在 Laravel 中操作起来非常简单。比如，你要为 404 HTTP 状态码指定一个错误页面，创建 resources/views/errors/404.blade.php 文件即可，当 404 异常发生时，会自动采用这个页面。就是说你在 resources/views/errors/ 目录下，直接以 HTTP 状态码定义的文件，最终都会在对应异常发生时采用、并渲染出来。abort 函数产生的 HttpException 实例对象会以 $exception 变量的形式传递给视图。
{{ $exception->getMessage() }}
日志记录
Laravel 在强大的 Monolog 库之上提供了一个简单的抽象层。默认，Laravel 是在 storage/logs 目录下创建日志文件的。你可以使用 Log 门面记录日志。
namespace App\Http\Controllers;
use App\User;
use Illuminate\Support\Facades\Log;
use App\Http\Controllers\Controller;
class UserController extends Controller
{
/**
* Show the profile for the given user.
*
* @param int $id
* @return Response
*/
public function showProfile($id)
{
Log::info('Showing user profile for user: '.$id);
return view('user.profile', ['user' => User::findOrFail($id)]);
}
}
咱们的 Log 提供了在 RFC 5424 定义的 8 个日志等级，分别是： emergency、alert、critical、error、warning、notice、info 和 debug。
Log::emergency($message);
Log::alert($message);
Log::critical($message);
Log::error($message);
Log::warning($message);
Log::notice($message);
Log::info($message);
Log::debug($message);
文本信息
也可以给 Log 的这些方法传递可选的文本信息，这些信息会被格式化，输出在日志信息中。
Log::info('User failed to login.', ['id' => $user->id]);
获得底层 Monolog 实例对象
Monolog 还有许多其他的日志处理方法，如果需要，你可以直接访问底层的 Monolog 实例对象：
$monolog = Log::getMonolog();
本作品采用《CC 协议》，转载必须注明作者和本文链接