aboutsummaryrefslogtreecommitdiffstats
path: root/lib/public
diff options
context:
space:
mode:
authorFerdinand Thiessen <opensource@fthiessen.de>2024-09-19 00:37:06 +0200
committerFerdinand Thiessen <opensource@fthiessen.de>2024-09-19 00:37:06 +0200
commit5cce140701638aabac9ca692433b45517b741161 (patch)
tree90b493d92f6fee7f9527628a3a2c42ead7d92d4b /lib/public
parentf1dfd6ba71b476366694fdcdfb75f85e90535203 (diff)
downloadnextcloud-server-5cce140701638aabac9ca692433b45517b741161.tar.gz
nextcloud-server-5cce140701638aabac9ca692433b45517b741161.zip
chore: Remove deprecated `ILogger` logging functionschore/remove-ilogger
Signed-off-by: Ferdinand Thiessen <opensource@fthiessen.de>
Diffstat (limited to 'lib/public')
-rw-r--r--lib/public/ILogger.php135
-rw-r--r--lib/public/IServerContainer.php9
2 files changed, 5 insertions, 139 deletions
diff --git a/lib/public/ILogger.php b/lib/public/ILogger.php
index 0716dae07d6..54f9ffeca9a 100644
--- a/lib/public/ILogger.php
+++ b/lib/public/ILogger.php
@@ -9,157 +9,32 @@ declare(strict_types=1);
namespace OCP;
/**
- * Interface ILogger
- * @since 7.0.0
+ * Nextcloud logging levels.
+ * For historical reasons the logging levels are provided as interface constants.
*
- * This logger interface follows the design guidelines of PSR-3
- * https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-3-logger-interface.md#3-psrlogloggerinterface
- * @deprecated 20.0.0 use the PSR-3 logger \Psr\Log\LoggerInterface
+ * @since 7.0.0
+ * @since 20.0.0 deprecated logging methods in favor of \Psr\Log\LoggerInterface
+ * @since 31.0.0 removed deprecated logging methods - the interface is kept for Nextcloud log levels
*/
interface ILogger {
/**
* @since 14.0.0
- * @deprecated 20.0.0
*/
public const DEBUG = 0;
/**
* @since 14.0.0
- * @deprecated 20.0.0
*/
public const INFO = 1;
/**
* @since 14.0.0
- * @deprecated 20.0.0
*/
public const WARN = 2;
/**
* @since 14.0.0
- * @deprecated 20.0.0
*/
public const ERROR = 3;
/**
* @since 14.0.0
- * @deprecated 20.0.0
*/
public const FATAL = 4;
-
- /**
- * System is unusable.
- *
- * @param string $message
- * @param array $context
- * @return null
- * @since 7.0.0
- * @deprecated 20.0.0 use \Psr\Log\LoggerInterface::emergency
- */
- public function emergency(string $message, array $context = []);
-
- /**
- * Action must be taken immediately.
- *
- * @param string $message
- * @param array $context
- * @return null
- * @since 7.0.0
- * @deprecated 20.0.0 use \Psr\Log\LoggerInterface::alert
- */
- public function alert(string $message, array $context = []);
-
- /**
- * Critical conditions.
- *
- * @param string $message
- * @param array $context
- * @return null
- * @since 7.0.0
- * @deprecated 20.0.0 use \Psr\Log\LoggerInterface::critical
- */
- public function critical(string $message, array $context = []);
-
- /**
- * Runtime errors that do not require immediate action but should typically
- * be logged and monitored.
- *
- * @param string $message
- * @param array $context
- * @return null
- * @since 7.0.0
- * @deprecated 20.0.0 use \Psr\Log\LoggerInterface::error
- */
- public function error(string $message, array $context = []);
-
- /**
- * Exceptional occurrences that are not errors.
- *
- * @param string $message
- * @param array $context
- * @return null
- * @since 7.0.0
- * @deprecated 20.0.0 use \Psr\Log\LoggerInterface::warning
- */
- public function warning(string $message, array $context = []);
-
- /**
- * Normal but significant events.
- *
- * @param string $message
- * @param array $context
- * @return null
- * @since 7.0.0
- * @deprecated 20.0.0 use \Psr\Log\LoggerInterface::notice
- */
- public function notice(string $message, array $context = []);
-
- /**
- * Interesting events.
- *
- * @param string $message
- * @param array $context
- * @return null
- * @since 7.0.0
- * @deprecated 20.0.0 use \Psr\Log\LoggerInterface::info
- */
- public function info(string $message, array $context = []);
-
- /**
- * Detailed debug information.
- *
- * @param string $message
- * @param array $context
- * @return null
- * @since 7.0.0
- * @deprecated 20.0.0 use \Psr\Log\LoggerInterface::debug
- */
- public function debug(string $message, array $context = []);
-
- /**
- * Logs with an arbitrary level.
- *
- * @param int $level
- * @param string $message
- * @param array $context
- * @return mixed
- * @since 7.0.0
- * @deprecated 20.0.0 use \Psr\Log\LoggerInterface::log
- */
- public function log(int $level, string $message, array $context = []);
-
- /**
- * Logs an exception very detailed
- * An additional message can we written to the log by adding it to the
- * context.
- *
- * <code>
- * $logger->logException($ex, [
- * 'message' => 'Exception during background job execution'
- * ]);
- * </code>
- *
- * @param \Exception|\Throwable $exception
- * @param array $context
- * @return void
- * @since 8.2.0
- * @deprecated 20.0.0 use the `exception` entry in the context of any method in \Psr\Log\LoggerInterface
- */
- public function logException(\Throwable $exception, array $context = []);
}
diff --git a/lib/public/IServerContainer.php b/lib/public/IServerContainer.php
index 027dfcb77c4..82da8779a66 100644
--- a/lib/public/IServerContainer.php
+++ b/lib/public/IServerContainer.php
@@ -317,15 +317,6 @@ interface IServerContainer extends ContainerInterface, IContainer {
public function getJobList();
/**
- * Returns a logger instance
- *
- * @return \OCP\ILogger
- * @since 8.0.0
- * @deprecated 20.0.0 have it injected or fetch it through \Psr\Container\ContainerInterface::get
- */
- public function getLogger();
-
- /**
* returns a log factory instance
*
* @return ILogFactory