friendica/src/Core/Logger.php

222 lines
5.4 KiB
PHP
Raw Normal View History

<?php
/**
2023-01-01 15:36:24 +01:00
* @copyright Copyright (C) 2010-2023, the Friendica project
2020-02-09 15:45:36 +01:00
*
* @license GNU AGPL version 3 or any later version
*
* This program 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.
*
* This program 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 Affero General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*
*/
2020-02-09 15:45:36 +01:00
namespace Friendica\Core;
use Friendica\DI;
2021-10-23 12:22:27 +02:00
use Friendica\Core\Logger\Type\WorkerLogger;
2018-12-30 21:42:56 +01:00
use Psr\Log\LoggerInterface;
use Psr\Log\LogLevel;
/**
2020-01-19 07:05:23 +01:00
* Logger functions
*/
class Logger
{
/**
* @var LoggerInterface The default Logger type
*/
const TYPE_LOGGER = LoggerInterface::class;
/**
* @var WorkerLogger A specific worker logger type, which can be anabled
*/
const TYPE_WORKER = WorkerLogger::class;
/**
* @var LoggerInterface The current logger type
*/
private static $type = self::TYPE_LOGGER;
/**
* @return LoggerInterface
*/
private static function getInstance()
{
if (self::$type === self::TYPE_LOGGER) {
return DI::logger();
} else {
return DI::workerLogger();
}
}
2018-12-30 21:42:56 +01:00
/**
* Enable additional logging for worker usage
*
* @param string $functionName The worker function, which got called
2018-12-30 21:42:56 +01:00
*
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
2018-12-30 21:42:56 +01:00
*/
public static function enableWorker(string $functionName)
2018-12-30 21:42:56 +01:00
{
self::$type = self::TYPE_WORKER;
self::getInstance()->setFunctionName($functionName);
2018-12-30 21:42:56 +01:00
}
/**
* Disable additional logging for worker usage
2018-12-30 21:42:56 +01:00
*/
public static function disableWorker()
2018-12-30 21:42:56 +01:00
{
self::$type = self::TYPE_LOGGER;
2018-12-30 21:42:56 +01:00
}
/**
* System is unusable.
2019-01-06 22:06:53 +01:00
*
2018-12-30 21:42:56 +01:00
* @see LoggerInterface::emergency()
*
* @param string $message Message to log
* @param array $context Optional variables
2018-12-30 21:42:56 +01:00
* @return void
2019-01-06 22:06:53 +01:00
* @throws \Exception
2018-12-30 21:42:56 +01:00
*/
public static function emergency(string $message, array $context = [])
2018-12-30 21:42:56 +01:00
{
self::getInstance()->emergency($message, $context);
2018-12-30 21:42:56 +01:00
}
/**
* Action must be taken immediately.
* @see LoggerInterface::alert()
*
* Example: Entire website down, database unavailable, etc. This should
* trigger the SMS alerts and wake you up.
*
* @param string $message Message to log
* @param array $context Optional variables
2018-12-30 21:42:56 +01:00
* @return void
2019-01-06 22:06:53 +01:00
* @throws \Exception
2018-12-30 21:42:56 +01:00
*/
public static function alert(string $message, array $context = [])
2018-12-30 21:42:56 +01:00
{
self::getInstance()->alert($message, $context);
2018-12-30 21:42:56 +01:00
}
/**
* Critical conditions.
* @see LoggerInterface::critical()
*
* Example: Application component unavailable, unexpected exception.
*
* @param string $message Message to log
* @param array $context Optional variables
2018-12-30 21:42:56 +01:00
* @return void
2019-01-06 22:06:53 +01:00
* @throws \Exception
2018-12-30 21:42:56 +01:00
*/
public static function critical(string $message, array $context = [])
2018-12-30 21:42:56 +01:00
{
self::getInstance()->critical($message, $context);
2018-12-30 21:42:56 +01:00
}
/**
* Runtime errors that do not require immediate action but should typically
* be logged and monitored.
* @see LoggerInterface::error()
*
* @param string $message Message to log
* @param array $context Optional variables
2018-12-30 21:42:56 +01:00
* @return void
2019-01-06 22:06:53 +01:00
* @throws \Exception
2018-12-30 21:42:56 +01:00
*/
public static function error(string $message, array $context = [])
2018-12-30 21:42:56 +01:00
{
self::getInstance()->error($message, $context);
2018-12-30 21:42:56 +01:00
}
/**
* Exceptional occurrences that are not errors.
* @see LoggerInterface::warning()
*
* Example: Use of deprecated APIs, poor use of an API, undesirable things
* that are not necessarily wrong.
*
* @param string $message Message to log
* @param array $context Optional variables
2018-12-30 21:42:56 +01:00
* @return void
2019-01-06 22:06:53 +01:00
* @throws \Exception
2018-12-30 21:42:56 +01:00
*/
public static function warning(string $message, array $context = [])
2018-12-30 21:42:56 +01:00
{
self::getInstance()->warning($message, $context);
2018-12-30 21:42:56 +01:00
}
/**
* Normal but significant events.
* @see LoggerInterface::notice()
*
* @param string $message Message to log
* @param array $context Optional variables
2018-12-30 21:42:56 +01:00
* @return void
2019-01-06 22:06:53 +01:00
* @throws \Exception
2018-12-30 21:42:56 +01:00
*/
public static function notice(string $message, array $context = [])
2018-12-30 21:42:56 +01:00
{
self::getInstance()->notice($message, $context);
2018-12-30 21:42:56 +01:00
}
/**
* Interesting events.
* @see LoggerInterface::info()
*
* Example: User logs in, SQL logs.
*
* @param string $message
* @param array $context
*
* @return void
2019-01-06 22:06:53 +01:00
* @throws \Exception
2018-12-30 21:42:56 +01:00
*/
public static function info(string $message, array $context = [])
2018-12-30 21:42:56 +01:00
{
self::getInstance()->info($message, $context);
2018-12-30 21:42:56 +01:00
}
/**
* Detailed debug information.
* @see LoggerInterface::debug()
*
* @param string $message Message to log
* @param array $context Optional variables
2018-12-30 21:42:56 +01:00
* @return void
2019-01-06 22:06:53 +01:00
* @throws \Exception
2018-12-30 21:42:56 +01:00
*/
public static function debug(string $message, array $context = [])
2018-12-30 21:42:56 +01:00
{
self::getInstance()->debug($message, $context);
2018-12-30 21:42:56 +01:00
}
2019-01-06 22:06:53 +01:00
/**
2020-01-19 07:05:23 +01:00
* An alternative logger for development.
*
2019-01-06 22:06:53 +01:00
* Works largely as log() but allows developers
* to isolate particular elements they are targetting
* personally without background noise
*
* @param string $message Message to log
* @param string $level Logging level
* @return void
2019-01-06 22:06:53 +01:00
* @throws \Exception
*/
public static function devLog(string $message, string $level = LogLevel::DEBUG)
2019-02-17 02:09:39 +01:00
{
DI::devLogger()->log($level, $message);
2019-02-17 02:09:39 +01:00
}
}