Laravel 错误及日志

错误

你的 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;
    }
}