错误
你的 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;
}
}
网友评论