[php 8.4] feat(logger): lazy logger

lib/private/Log/LazyLogger.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OC\Log;
+
+use OCP\IConfig;
+use OCP\ILogger;
+use OCP\Log\ILazyLogger;
+use Psr\Log\LoggerInterface;
+
+/**
+ * @inheritDoc
+ * @since 39.0.0
+ */
+class LazyLogger implements ILazyLogger {
+	public ?LazyLoggerInterface $debug = null;
+	public ?LazyLoggerInterface $info = null;
+	public ?LazyLoggerInterface $warning = null;
+	public ?LazyLoggerInterface $error = null;
+	public ?LazyLoggerInterface $fatal = null;
+
+	public function __construct(
+		LoggerInterface $logger,
+		IConfig $config,
+	) {
+		$logLevel = $config->getSystemValueInt('loglevel', ILogger::WARN);
+		if ($logLevel === ILogger::DEBUG) {
+			$this->debug = new LazyLoggerInterface($logger, ILogger::DEBUG);
+		}
+		if ($logLevel <= ILogger::INFO) {
+			$this->info = new LazyLoggerInterface($logger, ILogger::INFO);
+		}
+		if ($logLevel <= ILogger::WARN) {
+			$this->warning = new LazyLoggerInterface($logger, ILogger::WARN);
+		}
+		if ($logLevel <= ILogger::ERROR) {
+			$this->error = new LazyLoggerInterface($logger, ILogger::ERROR);
+		}
+		$this->fatal = new LazyLoggerInterface($logger, ILogger::FATAL);
+	}
+}

lib/private/Log/LazyLoggerInterface.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OC\Log;
+
+use OCP\Log\ILazyLoggerInterface;
+use Psr\Log\LoggerInterface;
+
+class LazyLoggerInterface implements ILazyLoggerInterface {
+	public function __construct(
+		private readonly LoggerInterface $logger,
+		private readonly int $level,
+	) {
+	}
+
+	public function print(string $message, array $context = []): void {
+		$this->logger->log($this->level, $message, $context);
+	}
+}

lib/private/Server.php

@@ -576,6 +576,7 @@ public function __construct(
 		});
 		// PSR-3 logger
 		$this->registerAlias(LoggerInterface::class, PsrLoggerAdapter::class);
+		$this->registerAlias(\OCP\Log\ILazyLogger::class, \OC\Log\LazyLogger::class);
 
 		$this->registerAlias(ILogFactory::class, LogFactory::class);
 		$this->registerAlias(IJobList::class, JobList::class);

lib/public/Log/ILazyLogger.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCP\Log;
+
+/**
+ * will only initialize the payload if needed:
+ *    $this->logger->debug?->print('my message', ['data' => my_heavy_process()]);
+ *
+ * if loglevel does not allow it, the payload will not be loaded/initialized
+ *
+ * @since 39.0.0
+ */
+interface ILazyLogger {
+	public ?ILazyLoggerInterface $debug { get; }
+	public ?ILazyLoggerInterface $info { get; }
+	public ?ILazyLoggerInterface $warning { get; }
+	public ?ILazyLoggerInterface $error { get; }
+	public ?ILazyLoggerInterface $fatal { get; }
+}

lib/public/Log/ILazyLoggerInterface.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCP\Log;
+
+interface ILazyLoggerInterface {
+	public function print(string $message, array $context = []): void;
+}