414 lines
12 KiB
PHP
414 lines
12 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Logger module.
|
|
*
|
|
* This file is part of MadelineProto.
|
|
* MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
|
|
* MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
* See the GNU Affero General Public License for more details.
|
|
* You should have received a copy of the GNU General Public License along with MadelineProto.
|
|
* If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* @author Daniil Gentili <daniil@daniil.it>
|
|
* @copyright 2016-2020 Daniil Gentili <daniil@daniil.it>
|
|
* @license https://opensource.org/licenses/AGPL-3.0 AGPLv3
|
|
*
|
|
* @link https://docs.madelineproto.xyz MadelineProto documentation
|
|
*/
|
|
|
|
namespace danog\MadelineProto;
|
|
|
|
use Amp\ByteStream\ResourceOutputStream;
|
|
use Amp\Failure;
|
|
use Amp\Loop;
|
|
use danog\MadelineProto\Settings\Logger as SettingsLogger;
|
|
use Psr\Log\LoggerInterface;
|
|
|
|
use function Amp\ByteStream\getStderr;
|
|
use function Amp\ByteStream\getStdout;
|
|
|
|
/**
|
|
* Logger class.
|
|
*/
|
|
class Logger
|
|
{
|
|
/**
|
|
* @internal ANSI foreground color escapes
|
|
*/
|
|
const FOREGROUND = ['default' => 39, 'black' => 30, 'red' => 31, 'green' => 32, 'yellow' => 33, 'blue' => 34, 'magenta' => 35, 'cyan' => 36, 'light_gray' => 37, 'dark_gray' => 90, 'light_red' => 91, 'light_green' => 92, 'light_yellow' => 93, 'light_blue' => 94, 'light_magenta' => 95, 'light_cyan' => 96, 'white' => 97];
|
|
/**
|
|
* @internal ANSI background color escapes
|
|
*/
|
|
const BACKGROUND = ['default' => 49, 'black' => 40, 'red' => 41, 'magenta' => 45, 'yellow' => 43, 'green' => 42, 'blue' => 44, 'cyan' => 46, 'light_gray' => 47, 'dark_gray' => 100, 'light_red' => 101, 'light_green' => 102, 'light_yellow' => 103, 'light_blue' => 104, 'light_magenta' => 105, 'light_cyan' => 106, 'white' => 107];
|
|
/**
|
|
* @internal ANSI modifier escapes
|
|
*/
|
|
const SET = ['bold' => 1, 'dim' => 2, 'underlined' => 3, 'blink' => 4, 'reverse' => 5, 'hidden' => 6];
|
|
/**
|
|
* @internal ANSI reset modifier escapes
|
|
*/
|
|
const RESET = ['all' => 0, 'bold' => 21, 'dim' => 22, 'underlined' => 24, 'blink' => 25, 'reverse' => 26, 'hidden' => 28];
|
|
/**
|
|
* Logging mode.
|
|
*
|
|
* @var integer
|
|
*/
|
|
public $mode = 0;
|
|
/**
|
|
* Optional logger parameter.
|
|
*
|
|
* @var null|string|callable
|
|
*/
|
|
public $optional = null;
|
|
/**
|
|
* Logger prefix.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $prefix = '';
|
|
/**
|
|
* Logging level.
|
|
*
|
|
* @var integer
|
|
*/
|
|
public $level = self::NOTICE;
|
|
/**
|
|
* Logging colors.
|
|
*
|
|
* @var array
|
|
*/
|
|
public $colors = [];
|
|
/**
|
|
* Newline.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $newline = "\n";
|
|
/**
|
|
* Logfile.
|
|
*
|
|
* @var ResourceOutputStream
|
|
*/
|
|
public $stdout;
|
|
/**
|
|
* Default logger instance.
|
|
*
|
|
* @var self
|
|
*/
|
|
public static $default;
|
|
/**
|
|
* Whether the AGPL notice was printed.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public static $printed = false;
|
|
/**
|
|
* Log rotation loop ID.
|
|
*/
|
|
private string $rotateId = '';
|
|
/**
|
|
* PSR logger.
|
|
*/
|
|
private PsrLogger $psr;
|
|
/**
|
|
* Ultra verbose logging.
|
|
*
|
|
* @internal
|
|
*/
|
|
const ULTRA_VERBOSE = 5;
|
|
/**
|
|
* Verbose logging.
|
|
*
|
|
* @internal
|
|
*/
|
|
const VERBOSE = 4;
|
|
/**
|
|
* Notice logging.
|
|
*
|
|
* @internal
|
|
*/
|
|
const NOTICE = 3;
|
|
/**
|
|
* Warning logging.
|
|
*
|
|
* @internal
|
|
*/
|
|
const WARNING = 2;
|
|
/**
|
|
* Error logging.
|
|
*
|
|
* @internal
|
|
*/
|
|
const ERROR = 1;
|
|
/**
|
|
* Log only fatal errors.
|
|
*
|
|
* @internal
|
|
*/
|
|
const FATAL_ERROR = 0;
|
|
|
|
/**
|
|
* Disable logger (DEPRECATED).
|
|
*
|
|
* @internal
|
|
* @deprecated
|
|
*/
|
|
const NO_LOGGER = 0;
|
|
/**
|
|
* Default logger (syslog).
|
|
*
|
|
* @internal
|
|
*/
|
|
const DEFAULT_LOGGER = 1;
|
|
/**
|
|
* File logger.
|
|
*
|
|
* @internal
|
|
*/
|
|
const FILE_LOGGER = 2;
|
|
/**
|
|
* Echo logger.
|
|
*
|
|
* @internal
|
|
*/
|
|
const ECHO_LOGGER = 3;
|
|
/**
|
|
* Callable logger.
|
|
*
|
|
* @internal
|
|
*/
|
|
const CALLABLE_LOGGER = 4;
|
|
|
|
/**
|
|
* Ultra verbose level.
|
|
*/
|
|
const LEVEL_ULTRA_VERBOSE = self::ULTRA_VERBOSE;
|
|
/**
|
|
* Verbose level.
|
|
*/
|
|
const LEVEL_VERBOSE = self::VERBOSE;
|
|
/**
|
|
* Notice level.
|
|
*/
|
|
const LEVEL_NOTICE = self::NOTICE;
|
|
/**
|
|
* Warning level.
|
|
*/
|
|
const LEVEL_WARNING = self::WARNING;
|
|
/**
|
|
* Error level.
|
|
*/
|
|
const LEVEL_ERROR = self::ERROR;
|
|
/**
|
|
* Fatal error level.
|
|
*/
|
|
const LEVEL_FATAL = self::FATAL_ERROR;
|
|
|
|
/**
|
|
* Default logger (syslog).
|
|
*/
|
|
const LOGGER_DEFAULT = self::DEFAULT_LOGGER;
|
|
/**
|
|
* Echo logger.
|
|
*/
|
|
const LOGGER_ECHO = self::ECHO_LOGGER;
|
|
/**
|
|
* File logger.
|
|
*/
|
|
const LOGGER_FILE = self::FILE_LOGGER;
|
|
/**
|
|
* Callable logger.
|
|
*/
|
|
const LOGGER_CALLABLE = self::CALLABLE_LOGGER;
|
|
|
|
/**
|
|
* Construct global static logger from MadelineProto settings.
|
|
*
|
|
* @param SettingsLogger $settings Settings instance
|
|
*
|
|
* @return self
|
|
*/
|
|
public static function constructorFromSettings(SettingsLogger $settings): self
|
|
{
|
|
return self::$default = new self($settings);
|
|
}
|
|
|
|
/**
|
|
* Construct logger.
|
|
*
|
|
* @param SettingsLogger $settings
|
|
* @param string $prefix
|
|
*/
|
|
public function __construct(SettingsLogger $settings, string $prefix = '')
|
|
{
|
|
$this->psr = new PsrLogger($this);
|
|
$this->prefix = $prefix === '' ? '' : ', '.$prefix;
|
|
|
|
$this->mode = $settings->getType();
|
|
$this->optional = $settings->getExtra();
|
|
$this->level = $settings->getLevel();
|
|
|
|
$maxSize = $settings->getMaxSize();
|
|
|
|
if ($this->mode === self::FILE_LOGGER) {
|
|
if (!\file_exists(\pathinfo($this->optional, PATHINFO_DIRNAME))) {
|
|
$this->optional = Magic::$script_cwd.'/MadelineProto.log';
|
|
}
|
|
if (!str_ends_with($this->optional, '.log')) {
|
|
$this->optional .= '.log';
|
|
}
|
|
if ($maxSize !== -1 && \file_exists($this->optional) && \filesize($this->optional) > $maxSize) {
|
|
\unlink($this->optional);
|
|
}
|
|
}
|
|
$this->colors[self::ULTRA_VERBOSE] = \implode(';', [self::FOREGROUND['light_gray'], self::SET['dim']]);
|
|
$this->colors[self::VERBOSE] = \implode(';', [self::FOREGROUND['green'], self::SET['bold']]);
|
|
$this->colors[self::NOTICE] = \implode(';', [self::FOREGROUND['yellow'], self::SET['bold']]);
|
|
$this->colors[self::WARNING] = \implode(';', [self::FOREGROUND['white'], self::SET['dim'], self::BACKGROUND['red']]);
|
|
$this->colors[self::ERROR] = \implode(';', [self::FOREGROUND['white'], self::SET['bold'], self::BACKGROUND['red']]);
|
|
$this->colors[self::FATAL_ERROR] = \implode(';', [self::FOREGROUND['red'], self::SET['bold'], self::BACKGROUND['light_gray']]);
|
|
$this->newline = PHP_EOL;
|
|
if ($this->mode === self::ECHO_LOGGER) {
|
|
$this->stdout = getStdout();
|
|
if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') {
|
|
$this->newline = '<br>'.$this->newline;
|
|
}
|
|
} elseif ($this->mode === self::FILE_LOGGER) {
|
|
Snitch::logFile($this->optional);
|
|
$this->stdout = new ResourceOutputStream(\fopen($this->optional, 'a'));
|
|
if ($maxSize !== -1) {
|
|
$optional = &$this->optional;
|
|
$stdout = &$this->stdout;
|
|
$this->rotateId = Loop::repeat(
|
|
10*1000,
|
|
static function () use ($maxSize, $optional, &$stdout) {
|
|
\clearstatcache(true, $optional);
|
|
if (\file_exists($optional) && \filesize($optional) >= $maxSize) {
|
|
$stdout->close();
|
|
$stdout = null;
|
|
\unlink($optional);
|
|
$stdout = new ResourceOutputStream(\fopen($optional, 'a'));
|
|
self::log("Automatically truncated logfile to $maxSize");
|
|
}
|
|
}
|
|
);
|
|
Loop::unreference($this->rotateId);
|
|
}
|
|
} elseif ($this->mode === self::DEFAULT_LOGGER) {
|
|
$result = @\ini_get('error_log');
|
|
if ($result === 'syslog') {
|
|
$this->stdout = getStderr();
|
|
} elseif ($result) {
|
|
$this->stdout = new ResourceOutputStream(\fopen($result, 'a+'));
|
|
} else {
|
|
$this->stdout = getStderr();
|
|
}
|
|
}
|
|
|
|
self::$default = $this;
|
|
if (PHP_SAPI !== 'cli' && PHP_SAPI !== 'phpdbg') {
|
|
try {
|
|
\error_reporting(E_ALL);
|
|
\ini_set('log_errors', "1");
|
|
\ini_set('error_log', $this->mode === self::FILE_LOGGER
|
|
? $this->optional
|
|
: Magic::$script_cwd.'/MadelineProto.log');
|
|
\error_log('Enabled PHP logging');
|
|
} catch (\danog\MadelineProto\Exception $e) {
|
|
$this->logger('Could not enable PHP logging');
|
|
}
|
|
}
|
|
}
|
|
/**
|
|
* Destructor function.
|
|
*/
|
|
public function __destruct()
|
|
{
|
|
if ($this->rotateId) {
|
|
Loop::cancel($this->rotateId);
|
|
}
|
|
}
|
|
/**
|
|
* Log a message.
|
|
*
|
|
* @param mixed $param Message
|
|
* @param int $level Logging level
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function log($param, int $level = self::NOTICE)
|
|
{
|
|
if (!\is_null(self::$default)) {
|
|
self::$default->logger($param, $level, \basename(\debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1)[0]['file'], '.php'));
|
|
} else {
|
|
echo $param.PHP_EOL;
|
|
}
|
|
}
|
|
/**
|
|
* Log a message.
|
|
*
|
|
* @param mixed $param Message to log
|
|
* @param int $level Logging level
|
|
* @param string $file File that originated the message
|
|
*
|
|
* @return void
|
|
*/
|
|
public function logger($param, int $level = self::NOTICE, string $file = ''): void
|
|
{
|
|
if ($level > $this->level || $this->mode === self::NO_LOGGER) {
|
|
return;
|
|
}
|
|
if (!self::$printed) {
|
|
self::$printed = true;
|
|
$this->colors[self::NOTICE] = \implode(';', [self::FOREGROUND['light_gray'], self::SET['bold'], self::BACKGROUND['blue']]);
|
|
$this->logger('MadelineProto');
|
|
$this->logger('Copyright (C) 2016-2020 Daniil Gentili');
|
|
$this->logger('Licensed under AGPLv3');
|
|
$this->logger('https://github.com/danog/MadelineProto');
|
|
$this->colors[self::NOTICE] = \implode(';', [self::FOREGROUND['yellow'], self::SET['bold']]);
|
|
}
|
|
if ($this->mode === self::CALLABLE_LOGGER) {
|
|
\call_user_func_array($this->optional, [$param, $level]);
|
|
return;
|
|
}
|
|
$prefix = $this->prefix;
|
|
if ($param instanceof \Throwable) {
|
|
$param = (string) $param;
|
|
} elseif (!\is_string($param)) {
|
|
$param = \json_encode($param, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
|
|
}
|
|
if (empty($file)) {
|
|
$file = \basename(\debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1)[0]['file'], '.php');
|
|
}
|
|
$param = \str_pad($file.$prefix.': ', 16 + \strlen($prefix))."\t".$param;
|
|
if ($this->mode === self::DEFAULT_LOGGER) {
|
|
if ($this->stdout->write($param.$this->newline) instanceof Failure) {
|
|
\error_log($param);
|
|
}
|
|
return;
|
|
}
|
|
$param = Magic::$isatty ? "\33[".$this->colors[$level].'m'.$param."\33[0m".$this->newline : $param.$this->newline;
|
|
if ($this->stdout->write($param) instanceof Failure) {
|
|
switch ($this->mode) {
|
|
case self::ECHO_LOGGER:
|
|
echo $param;
|
|
break;
|
|
case self::FILE_LOGGER:
|
|
\file_put_contents($this->optional, $param, FILE_APPEND);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get PSR logger.
|
|
*
|
|
* @return LoggerInterface
|
|
*/
|
|
public function getPsrLogger(): LoggerInterface
|
|
{
|
|
return $this->psr;
|
|
}
|
|
}
|