Laravel 错误及日志

2019-12-06 本文已影响0人 phpnet

错误

你的 config/app.php 配置文件中的 debug 选项决定了对于一个错误实际上将显示多少信息给用户。默认情况下，该选项的设置将遵照存储在 .env 文件中的 APP_DEBUG 环境变量的值。

对于本地开发，你应该将 APP_DEBUG 环境变量的值设置为 true 。在生产环境中，该值应始终为 false 。如果在生产中将该值设置为 true ，则可能会将敏感配置值暴露给应用程序的终端用户。

所有异常都是由 App\Exceptions\Handler 处理。这个类包含了两个方法：report 和 render。我们将详细的剖析这些方法。

report 方法用于记录异常或将它们发送给如 Bugsnag 或 Sentry 等外部服务。默认情况下，report 方法将异常传递给记录异常的基类。
render 方法负责将给定的异常转换为将被发送回浏览器的 HTTP 响应。默认情况下，异常将传递给为你生成响应的基类。

异常处理器的 $dontReport 属性包含一组不会被记录的异常类型。

有时你可能需要报告异常，但又不希望终止当前请求的处理。report 辅助函数允许你使用异常处理器的 report 方法在不显示错误页面的情况下快速报告异常。

abort 辅助函数从应用程序的任何地方报告并渲染异常。

abort(403, 'Unauthorized action.');

日志

所有的应用程序日志系统配置都位于 config/logging.php 配置文件中。这个文件允许你配置你的应用程序日志通道，所以务必查看每个可用的通道及它们的选项。

'stack' => [
    'driver' => 'stack',
    'name' => 'channel-name',
    'channels' => ['single', 'slack'],
]

stack 一个便于创建『多通道』通道的包装器
single 单个文件或者基于日志通道的路径 (StreamHandler)
daily 一个每天轮换的基于 Monolog 驱动的 RotatingFileHandler
slack 一个基于 Monolog 驱动的 SlackWebhookHandler
papertrail 一个基于 Monolog 驱动的 SyslogUdpHandler
syslog 一个基于 Monolog 驱动的 SyslogHandler
errorlog 一个基于 Monolog 驱动的 ErrorLogHandler
monolog 一个可以使用任何支持 Monolog 处理程序的 Monolog 工厂驱动程序
custom 一个调用指定工厂创建通道的驱动程序

日志级别

Monolog （一个功能强劲的 Laravel 日志服务）接受定义在 RFC 5424 specification 中的全部级别： 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);

自定义日志示例：

<?php
namespace App\Libraries;

use InvalidArgumentException;
use Monolog\Formatter\LineFormatter;
use Monolog\Handler\ErrorLogHandler;
use Monolog\Logger as MonologLogger;
use Illuminate\Contracts\Foundation\Application;

class ConfigureLogging
{

    /**
     * 应用实例
     *
     * @var Application
     */
    protected $app;

    /**
     * 日志级别
     *
     * @var array
     */
    protected $levels = [
        'debug' => MonologLogger::DEBUG,
        'info' => MonologLogger::INFO,
        'notice' => MonologLogger::NOTICE,
        'warning' => MonologLogger::WARNING,
        'error' => MonologLogger::ERROR,
        'critical' => MonologLogger::CRITICAL,
        'alert' => MonologLogger::ALERT,
        'emergency' => MonologLogger::EMERGENCY
    ];

    /**
     * 服务提供者
     *
     * @param Application $app
     * @return void
     */
    public function __construct(Application $app)
    {
        $this->app = $app;
    }

    /**
     * 创建日志
     *
     * @return mixed
     */
    public function createLogger()
    {
        $type = $this->handler();
        $level = $this->getLogLevel();
        switch ($type) {
            case 'single':
                $handler = new \Monolog\Handler\StreamHandler($this->getLogPath() . DIRECTORY_SEPARATOR . $this->getLogName() . '.log', $this->parseLevel($level));
                $handler->setFormatter($this->getDefaultFormatter());
                break;
            case 'daily':
                $handler = new \Monolog\Handler\RotatingFileHandler($this->getLogPath() . DIRECTORY_SEPARATOR . $this->getLogName() . '.log', $this->getMaxFiles(), $this->parseLevel($level));
                $handler->setFormatter($this->getDefaultFormatter());
                break;
            case 'syslog':
                $facility = LOG_USER;
                $handler = new \Monolog\Handler\SyslogHandler($this->getLogName(), $facility, $level);
                break;
            case 'errorlog':
                $messageType = ErrorLogHandler::OPERATING_SYSTEM;
                $handler = new \Monolog\Handler\ErrorLogHandler($messageType, $this->parseLevel($level));
                break;
        }
        return $handler;
    }

    /**
     * 获取默认格式
     *
     * @return \Monolog\Formatter\LineFormatter
     */
    protected function getDefaultFormatter()
    {
        return tap(new LineFormatter(null, 'Y-m-d H:i:s:u', true, true), function ($formatter) {
            $formatter->includeStacktraces();
        });
    }

    /**
     * 解析日志级别
     *
     * @param string $level
     * @return int
     *
     * @throws \InvalidArgumentException
     */
    protected function parseLevel($level)
    {
        if (isset($this->levels[$level])) {
            return $this->levels[$level];
        }
        throw new InvalidArgumentException('Invalid log level');
    }

    /**
     * 日志记录方式
     *
     * @return string
     */
    protected function handler()
    {
        $default = 'single';
        if ($this->app->bound('config')) {
            return $this->app->make('config')->get('app.log', $default);
        }
        return $default;
    }

    /**
     * 获取日志级别
     *
     * @return string
     */
    protected function getLogLevel()
    {
        $level = 'debug';
        if ($this->app->bound('config')) {
            return $this->app->make('config')->get('app.log_level', $level);
        }
        return $level;
    }

    /**
     * 最大日志数量
     *
     * @return int
     */
    protected function getMaxFiles()
    {
        $number = 30;
        if ($this->app->bound('config')) {
            return $this->app->make('config')->get('app.log_max_files', $number);
        }
        return $number;
    }

    /**
     * 获取日志路径
     *
     * @return string
     */
    protected function getLogPath()
    {
        $path = $this->app->storagePath() . DIRECTORY_SEPARATOR . 'logs';
        if ($this->app->bound('config')) {
            return $this->app->make('config')->get('app.log_path', $path);
        }
        return $path;
    }

    /**
     * 获取日志名称
     *
     * @return string
     */
    protected function getLogName()
    {
        $name = 'laravel';
        if ($this->app->bound('config')) {
            return $this->app->make('config')->get('app.log_name', $name);
        }
        return $name;
    }
}

Laravel 错误及日志

错误

日志

日志级别

猜你喜欢

热点阅读