From 65624e2c190f9d5a80f3839f1cf131a619f10af7 Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 07:14:31 +0000 Subject: [PATCH 01/23] Create FileSystemUtil interface --- src/Core/Logger/Util/FileSystem.php | 2 +- src/Core/Logger/Util/FileSystemUtil.php | 38 +++++++++++++++++++++++++ 2 files changed, 39 insertions(+), 1 deletion(-) create mode 100644 src/Core/Logger/Util/FileSystemUtil.php diff --git a/src/Core/Logger/Util/FileSystem.php b/src/Core/Logger/Util/FileSystem.php index 2d05faf50d..b1c402946a 100644 --- a/src/Core/Logger/Util/FileSystem.php +++ b/src/Core/Logger/Util/FileSystem.php @@ -12,7 +12,7 @@ use Friendica\Core\Logger\Exception\LoggerUnusableException; /** * Util class for filesystem manipulation for Logger classes */ -class FileSystem +class FileSystem implements FileSystemUtil { /** * @var string a error message diff --git a/src/Core/Logger/Util/FileSystemUtil.php b/src/Core/Logger/Util/FileSystemUtil.php new file mode 100644 index 0000000000..f4052b8c59 --- /dev/null +++ b/src/Core/Logger/Util/FileSystemUtil.php @@ -0,0 +1,38 @@ + Date: Mon, 14 Apr 2025 08:00:31 +0000 Subject: [PATCH 02/23] Create StreamLoggerFactory with tests --- .../Logger/Factory/StreamLoggerFactory.php | 76 ++++++++++++++++ .../Factory/StreamLoggerFactoryTest.php | 87 +++++++++++++++++++ 2 files changed, 163 insertions(+) create mode 100644 src/Core/Logger/Factory/StreamLoggerFactory.php create mode 100644 tests/Unit/Core/Logger/Factory/StreamLoggerFactoryTest.php diff --git a/src/Core/Logger/Factory/StreamLoggerFactory.php b/src/Core/Logger/Factory/StreamLoggerFactory.php new file mode 100644 index 0000000000..ef8beec100 --- /dev/null +++ b/src/Core/Logger/Factory/StreamLoggerFactory.php @@ -0,0 +1,76 @@ +config = $config; + $this->introspection = $introspection; + $this->fileSystem = $fileSystem; + } + + /** + * Creates and returns a PSR-3 Logger instance. + * + * Calling this method multiple times with the same parameters SHOULD return the same object. + * + * @param \Psr\Log\LogLevel::* $logLevel The log level + * @param \Friendica\Core\Logger\Capability\LogChannel::* $logChannel The log channel + * + * @throws LoggerArgumentException + * @throws LogLevelException + */ + public function createLogger(string $logLevel, string $logChannel): LoggerInterface + { + $logfile = $this->config->get('system', 'logfile'); + + if (!file_exists($logfile) || !is_writable($logfile)) { + throw new LoggerArgumentException(sprintf('"%s" is not a valid logfile.', $logfile)); + } + + if (! array_key_exists($logLevel, StreamLogger::levelToInt)) { + throw new LogLevelException(sprintf('The log level "%s" is not supported by "%s".', $logLevel, StreamLogger::class)); + } + + return new StreamLogger( + $logChannel, + $this->introspection, + $this->fileSystem->createStream($logfile), + StreamLogger::levelToInt[$logLevel], + getmypid() + ); + } +} diff --git a/tests/Unit/Core/Logger/Factory/StreamLoggerFactoryTest.php b/tests/Unit/Core/Logger/Factory/StreamLoggerFactoryTest.php new file mode 100644 index 0000000000..5f2020324f --- /dev/null +++ b/tests/Unit/Core/Logger/Factory/StreamLoggerFactoryTest.php @@ -0,0 +1,87 @@ +createConfiguredMock( + IManageConfigValues::class, + [ + 'get' => dirname(__DIR__, 4) . '/datasets/log/empty.friendica.log.txt', + ] + ); + + $factory = new StreamLoggerFactory( + $config, + $this->createStub(IHaveCallIntrospections::class), + $this->createStub(FileSystemUtil::class), + ); + + $this->assertInstanceOf( + LoggerInterface::class, + $factory->createLogger(LogLevel::DEBUG, LogChannel::DEFAULT) + ); + } + + public function testCreateLoggerWithInvalidLogfileThrowsException(): void + { + $config = $this->createConfiguredMock( + IManageConfigValues::class, + [ + 'get' => dirname(__DIR__, 1) . '/not-existing-logfile.txt', + ] + ); + + $factory = new StreamLoggerFactory( + $config, + $this->createStub(IHaveCallIntrospections::class), + $this->createStub(FileSystemUtil::class), + ); + + $this->expectException(LoggerArgumentException::class); + $this->expectExceptionMessage('tests/Unit/Core/Logger/not-existing-logfile.txt" is not a valid logfile.'); + + $factory->createLogger(LogLevel::DEBUG, LogChannel::DEFAULT); + } + + public function testCreateLoggerWithInvalidLoglevelThrowsException(): void + { + $config = $this->createConfiguredMock( + IManageConfigValues::class, + [ + 'get' => dirname(__DIR__, 4) . '/datasets/log/empty.friendica.log.txt', + ] + ); + + $factory = new StreamLoggerFactory( + $config, + $this->createStub(IHaveCallIntrospections::class), + $this->createStub(FileSystemUtil::class), + ); + + $this->expectException(LogLevelException::class); + $this->expectExceptionMessage('The log level "unsupported-loglevel" is not supported by "Friendica\Core\Logger\Type\StreamLogger".'); + + $factory->createLogger('unsupported-loglevel', LogChannel::DEFAULT); + } +} From 0b41eb1528b99d92083f8259b93c7f5e92f72a5a Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 08:05:43 +0000 Subject: [PATCH 03/23] Deprecate StreamLogger factory in favour of StreamLoggerFactory --- src/Core/Logger/Factory/StreamLogger.php | 2 ++ src/Core/Logger/Factory/StreamLoggerFactory.php | 6 +----- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/src/Core/Logger/Factory/StreamLogger.php b/src/Core/Logger/Factory/StreamLogger.php index e14fe8258f..b4fbe73dcc 100644 --- a/src/Core/Logger/Factory/StreamLogger.php +++ b/src/Core/Logger/Factory/StreamLogger.php @@ -20,6 +20,8 @@ use Psr\Log\NullLogger; /** * The logger factory for the StreamLogger instance * + * @deprecated 2025.02 Use `Friendica\Core\Logger\Factory\StreamLoggerFactory` instead + * @see StreamLoggerFactory * @see StreamLoggerClass */ class StreamLogger extends AbstractLoggerTypeFactory diff --git a/src/Core/Logger/Factory/StreamLoggerFactory.php b/src/Core/Logger/Factory/StreamLoggerFactory.php index ef8beec100..8717d6c695 100644 --- a/src/Core/Logger/Factory/StreamLoggerFactory.php +++ b/src/Core/Logger/Factory/StreamLoggerFactory.php @@ -9,22 +9,18 @@ namespace Friendica\Core\Logger\Factory; use Friendica\Core\Config\Capability\IManageConfigValues; use Friendica\Core\Logger\Capability\IHaveCallIntrospections; -use Friendica\Core\Logger\Capability\LogChannel; use Friendica\Core\Logger\Exception\LoggerArgumentException; -use Friendica\Core\Logger\Exception\LoggerException; use Friendica\Core\Logger\Exception\LogLevelException; use Friendica\Core\Logger\Type\StreamLogger; -use Friendica\Core\Logger\Util\FileSystem; use Friendica\Core\Logger\Util\FileSystemUtil; use Psr\Log\LoggerInterface; -use Psr\Log\NullLogger; /** * The logger factory for the StreamLogger instance * * @see StreamLogger */ -class StreamLoggerFactory implements LoggerFactory +final class StreamLoggerFactory implements LoggerFactory { private IManageConfigValues $config; From 0cec45149718602d19697d8224a5fafaa4fc2ede Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 10:36:12 +0000 Subject: [PATCH 04/23] Create SyslogLoggerFactory --- .../Logger/Factory/SyslogLoggerFactory.php | 64 +++++++++++++++++++ .../Factory/StreamLoggerFactoryTest.php | 30 ++++----- .../Factory/SyslogLoggerFactoryTest.php | 61 ++++++++++++++++++ 3 files changed, 137 insertions(+), 18 deletions(-) create mode 100644 src/Core/Logger/Factory/SyslogLoggerFactory.php create mode 100644 tests/Unit/Core/Logger/Factory/SyslogLoggerFactoryTest.php diff --git a/src/Core/Logger/Factory/SyslogLoggerFactory.php b/src/Core/Logger/Factory/SyslogLoggerFactory.php new file mode 100644 index 0000000000..44f9d79c73 --- /dev/null +++ b/src/Core/Logger/Factory/SyslogLoggerFactory.php @@ -0,0 +1,64 @@ +config = $config; + $this->introspection = $introspection; + } + + /** + * Creates and returns a PSR-3 Logger instance. + * + * Calling this method multiple times with the same parameters SHOULD return the same object. + * + * @param \Psr\Log\LogLevel::* $logLevel The log level + * @param \Friendica\Core\Logger\Capability\LogChannel::* $logChannel The log channel + * + * @throws LogLevelException + */ + public function createLogger(string $logLevel, string $logChannel): LoggerInterface + { + $logOpts = (string) $this->config->get('system', 'syslog_flags') ?? SyslogLogger::DEFAULT_FLAGS; + $logFacility = (string) $this->config->get('system', 'syslog_facility') ?? SyslogLogger::DEFAULT_FACILITY; + + if (!array_key_exists($logLevel, SyslogLogger::logLevels)) { + throw new LogLevelException(sprintf('The log level "%s" is not supported by "%s".', $logLevel, SyslogLogger::class)); + } + + return new SyslogLogger( + $logChannel, + $this->introspection, + (string) SyslogLogger::logLevels[$logLevel], + $logOpts, + $logFacility + ); + } +} diff --git a/tests/Unit/Core/Logger/Factory/StreamLoggerFactoryTest.php b/tests/Unit/Core/Logger/Factory/StreamLoggerFactoryTest.php index 5f2020324f..744d597f19 100644 --- a/tests/Unit/Core/Logger/Factory/StreamLoggerFactoryTest.php +++ b/tests/Unit/Core/Logger/Factory/StreamLoggerFactoryTest.php @@ -24,12 +24,10 @@ class StreamLoggerFactoryTest extends TestCase { public function testCreateLoggerReturnsPsrLogger(): void { - $config = $this->createConfiguredMock( - IManageConfigValues::class, - [ - 'get' => dirname(__DIR__, 4) . '/datasets/log/empty.friendica.log.txt', - ] - ); + $config = $this->createStub(IManageConfigValues::class); + $config->method('get')->willReturnMap([ + ['system', 'logfile', null, dirname(__DIR__, 4) . '/datasets/log/empty.friendica.log.txt'], + ]); $factory = new StreamLoggerFactory( $config, @@ -45,12 +43,10 @@ class StreamLoggerFactoryTest extends TestCase public function testCreateLoggerWithInvalidLogfileThrowsException(): void { - $config = $this->createConfiguredMock( - IManageConfigValues::class, - [ - 'get' => dirname(__DIR__, 1) . '/not-existing-logfile.txt', - ] - ); + $config = $this->createStub(IManageConfigValues::class); + $config->method('get')->willReturnMap([ + ['system', 'logfile', null, dirname(__DIR__, 1) . '/not-existing-logfile.txt'], + ]); $factory = new StreamLoggerFactory( $config, @@ -66,12 +62,10 @@ class StreamLoggerFactoryTest extends TestCase public function testCreateLoggerWithInvalidLoglevelThrowsException(): void { - $config = $this->createConfiguredMock( - IManageConfigValues::class, - [ - 'get' => dirname(__DIR__, 4) . '/datasets/log/empty.friendica.log.txt', - ] - ); + $config = $this->createStub(IManageConfigValues::class); + $config->method('get')->willReturnMap([ + ['system', 'logfile', null, dirname(__DIR__, 4) . '/datasets/log/empty.friendica.log.txt'], + ]); $factory = new StreamLoggerFactory( $config, diff --git a/tests/Unit/Core/Logger/Factory/SyslogLoggerFactoryTest.php b/tests/Unit/Core/Logger/Factory/SyslogLoggerFactoryTest.php new file mode 100644 index 0000000000..7f94c66fcd --- /dev/null +++ b/tests/Unit/Core/Logger/Factory/SyslogLoggerFactoryTest.php @@ -0,0 +1,61 @@ +createStub(IManageConfigValues::class); + $config->method('get')->willReturnMap([ + ['system', 'syslog_flags', null, SyslogLogger::DEFAULT_FLAGS], + ['system', 'syslog_facility', null, SyslogLogger::DEFAULT_FACILITY], + ]); + + $factory = new SyslogLoggerFactory( + $config, + $this->createStub(IHaveCallIntrospections::class), + ); + + $this->assertInstanceOf( + LoggerInterface::class, + $factory->createLogger(LogLevel::DEBUG, LogChannel::DEFAULT) + ); + } + + public function testCreateLoggerWithInvalidLoglevelThrowsException(): void + { + $config = $this->createStub(IManageConfigValues::class); + $config->method('get')->willReturnMap([ + ['system', 'syslog_flags', null, SyslogLogger::DEFAULT_FLAGS], + ['system', 'syslog_facility', null, SyslogLogger::DEFAULT_FACILITY], + ]); + + $factory = new SyslogLoggerFactory( + $config, + $this->createStub(IHaveCallIntrospections::class), + ); + + $this->expectException(LogLevelException::class); + $this->expectExceptionMessage('The log level "unsupported-loglevel" is not supported by "Friendica\Core\Logger\Type\SyslogLogger".'); + + $factory->createLogger('unsupported-loglevel', LogChannel::DEFAULT); + } +} From 252b3980d03df924994007062c2eb3ebeccc0d4a Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 10:47:11 +0000 Subject: [PATCH 05/23] Deprecate SyslogLogger factory in favour of SyslogLoggerFactory --- src/Core/Logger/Factory/StreamLoggerFactory.php | 2 ++ src/Core/Logger/Factory/SyslogLogger.php | 2 ++ 2 files changed, 4 insertions(+) diff --git a/src/Core/Logger/Factory/StreamLoggerFactory.php b/src/Core/Logger/Factory/StreamLoggerFactory.php index 8717d6c695..5a5b994f40 100644 --- a/src/Core/Logger/Factory/StreamLoggerFactory.php +++ b/src/Core/Logger/Factory/StreamLoggerFactory.php @@ -5,6 +5,8 @@ // // SPDX-License-Identifier: AGPL-3.0-or-later +declare(strict_types=1); + namespace Friendica\Core\Logger\Factory; use Friendica\Core\Config\Capability\IManageConfigValues; diff --git a/src/Core/Logger/Factory/SyslogLogger.php b/src/Core/Logger/Factory/SyslogLogger.php index e9b59f1186..f95dcb42ff 100644 --- a/src/Core/Logger/Factory/SyslogLogger.php +++ b/src/Core/Logger/Factory/SyslogLogger.php @@ -16,6 +16,8 @@ use Psr\Log\LoggerInterface; /** * The logger factory for the SyslogLogger instance * + * @deprecated 2025.02 Use `Friendica\Core\Logger\Factory\SyslogLoggerFactory` instead + * @see SyslogLoggerFactory * @see SyslogLoggerClass */ class SyslogLogger extends AbstractLoggerTypeFactory From 8fb2fae841aa1903fd44abdad0d41358bbbdc4cf Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 12:58:15 +0000 Subject: [PATCH 06/23] Create DelegatingLoggerFactory --- .../Factory/DelegatingLoggerFactory.php | 62 +++++++++++++++ .../Factory/DelegatingLoggerFactoryTest.php | 75 +++++++++++++++++++ 2 files changed, 137 insertions(+) create mode 100644 src/Core/Logger/Factory/DelegatingLoggerFactory.php create mode 100644 tests/Unit/Core/Logger/Factory/DelegatingLoggerFactoryTest.php diff --git a/src/Core/Logger/Factory/DelegatingLoggerFactory.php b/src/Core/Logger/Factory/DelegatingLoggerFactory.php new file mode 100644 index 0000000000..924e4e7d1a --- /dev/null +++ b/src/Core/Logger/Factory/DelegatingLoggerFactory.php @@ -0,0 +1,62 @@ + */ + private array $factories = []; + + public function __construct(IManageConfigValues $config) + { + $this->config = $config; + } + + public function registerFactory(string $name, LoggerFactory $factory): void + { + $this->factories[$name] = $factory; + } + + /** + * Creates and returns a PSR-3 Logger instance. + * + * Calling this method multiple times with the same parameters SHOULD return the same object. + * + * @param \Psr\Log\LogLevel::* $logLevel The log level + * @param \Friendica\Core\Logger\Capability\LogChannel::* $logChannel The log channel + */ + public function createLogger(string $logLevel, string $logChannel): LoggerInterface + { + $factoryName = $this->config->get('system', 'logger_config') ?? ''; + + if (!array_key_exists($factoryName, $this->factories)) { + return new NullLogger(); + } + + $factory = $this->factories[$factoryName]; + + try { + $logger = $factory->createLogger($logLevel, $logChannel); + } catch (\Throwable $th) { + return new NullLogger(); + } + + return $logger; + } +} diff --git a/tests/Unit/Core/Logger/Factory/DelegatingLoggerFactoryTest.php b/tests/Unit/Core/Logger/Factory/DelegatingLoggerFactoryTest.php new file mode 100644 index 0000000000..b0fd92cafd --- /dev/null +++ b/tests/Unit/Core/Logger/Factory/DelegatingLoggerFactoryTest.php @@ -0,0 +1,75 @@ +createStub(IManageConfigValues::class); + $config->method('get')->willReturnMap([ + ['system', 'logger_config', null, 'test'], + ]); + + $factory = new DelegatingLoggerFactory($config); + + $factory->registerFactory('test', $this->createStub(LoggerFactory::class)); + + $this->assertInstanceOf( + LoggerInterface::class, + $factory->createLogger(LogLevel::DEBUG, LogChannel::DEFAULT) + ); + } + + public function testCreateLoggerWithoutRegisteredFactoryReturnsNullLogger(): void + { + $config = $this->createStub(IManageConfigValues::class); + $config->method('get')->willReturnMap([ + ['system', 'logger_config', null, 'not-existing-factory'], + ]); + + $factory = new DelegatingLoggerFactory($config); + + $this->assertInstanceOf( + NullLogger::class, + $factory->createLogger(LogLevel::DEBUG, LogChannel::DEFAULT) + ); + } + + public function testCreateLoggerWithExceptionThrowingFactoryReturnsNullLogger(): void + { + $config = $this->createStub(IManageConfigValues::class); + $config->method('get')->willReturnMap([ + ['system', 'logger_config', null, 'test'], + ]); + + $factory = new DelegatingLoggerFactory($config); + + $brokenFactory = $this->createStub(LoggerFactory::class); + $brokenFactory->method('createLogger')->willThrowException(new Exception()); + + $factory->registerFactory('test', $brokenFactory); + + $this->assertInstanceOf( + NullLogger::class, + $factory->createLogger(LogLevel::DEBUG, LogChannel::DEFAULT) + ); + } +} From 6b36d3e87f7f9284cd98ad48b8e25afd4fd1fc4e Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 13:54:48 +0000 Subject: [PATCH 07/23] Replace LegacyLoggerFactory with DelegatingLoggerFactory --- static/dependencies.config.php | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/static/dependencies.config.php b/static/dependencies.config.php index 5924ae512e..644cb5f765 100644 --- a/static/dependencies.config.php +++ b/static/dependencies.config.php @@ -171,11 +171,24 @@ return (function(string $basepath, array $getVars, array $serverVars, array $coo ], \Friendica\Core\Logger\LoggerManager::class => [ 'substitutions' => [ - \Friendica\Core\Logger\Factory\LoggerFactory::class => \Friendica\Core\Logger\Factory\LegacyLoggerFactory::class, + \Friendica\Core\Logger\Factory\LoggerFactory::class => \Friendica\Core\Logger\Factory\DelegatingLoggerFactory::class, ], ], \Friendica\Core\Logger\Factory\LoggerFactory::class => [ - 'instanceOf' => \Friendica\Core\Logger\Factory\LegacyLoggerFactory::class, + 'instanceOf' => \Friendica\Core\Logger\Factory\DelegatingLoggerFactory::class, + 'call' => [ + ['registerFactory', ['stream', [Dice::INSTANCE => '$StreamLoggerFactory']]], + ['registerFactory', ['syslog', [Dice::INSTANCE => '$SyslogLoggerFactory']]], + ], + ], + '$StreamLoggerFactory' => [ + 'instanceOf' => \Friendica\Core\Logger\Factory\StreamLoggerFactory::class, + 'substitutions' => [ + \Friendica\Core\Logger\Util\FileSystemUtil::class => \Friendica\Core\Logger\Util\FileSystem::class, + ], + ], + '$SyslogLoggerFactory' => [ + 'instanceOf' => \Friendica\Core\Logger\Factory\SyslogLoggerFactory::class, ], \Friendica\Core\Logger\Type\SyslogLogger::class => [ 'instanceOf' => \Friendica\Core\Logger\Factory\SyslogLogger::class, From af29baf11e4847d3c8898018c90077bc318a7642 Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 14:36:46 +0000 Subject: [PATCH 08/23] deprecate value `monolog` for config `system.logger_config` --- src/Core/Logger/Factory/DelegatingLoggerFactory.php | 9 +++++++++ static/defaults.config.php | 3 ++- 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/src/Core/Logger/Factory/DelegatingLoggerFactory.php b/src/Core/Logger/Factory/DelegatingLoggerFactory.php index 924e4e7d1a..2091b51bd9 100644 --- a/src/Core/Logger/Factory/DelegatingLoggerFactory.php +++ b/src/Core/Logger/Factory/DelegatingLoggerFactory.php @@ -45,6 +45,15 @@ final class DelegatingLoggerFactory implements LoggerFactory { $factoryName = $this->config->get('system', 'logger_config') ?? ''; + /** + * @deprecated 2025.02 The value `monolog` for `system.logger_config` inside the `config/local.config.php` file is deprecated, please use `stream` or `syslog` instead. + */ + if ($factoryName === 'monolog') { + @trigger_error('The config `system.logger_config` with value `monolog` is deprecated since 2025.02 and will stop working in 5 months, please change the value to `stream` or `syslog` in the `config/local.config.php` file.', \E_USER_DEPRECATED); + + $factoryName = 'stream'; + } + if (!array_key_exists($factoryName, $this->factories)) { return new NullLogger(); } diff --git a/static/defaults.config.php b/static/defaults.config.php index d821ff1813..df84d66899 100644 --- a/static/defaults.config.php +++ b/static/defaults.config.php @@ -334,7 +334,8 @@ return [ 'lock_driver' => '', // logger_config (String) - // Sets the logging adapter of Friendica globally (monolog, syslog, stream) + // Sets the logging adapter of Friendica globally (syslog, stream) + // @deprecated 2025.02 The value `monolog` is deprecated, please use `stream` or `syslog` instead. 'logger_config' => 'stream', // syslog_flags (Integer) From fc1d8e92f3ef7d4150e6491432c34f812ba71f51 Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 14:38:49 +0000 Subject: [PATCH 09/23] Fix code style --- src/Core/Logger/Util/FileSystem.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Core/Logger/Util/FileSystem.php b/src/Core/Logger/Util/FileSystem.php index b1c402946a..97162dacb8 100644 --- a/src/Core/Logger/Util/FileSystem.php +++ b/src/Core/Logger/Util/FileSystem.php @@ -31,7 +31,7 @@ class FileSystem implements FileSystemUtil public function createDir(string $file): string { $dirname = null; - $pos = strpos($file, '://'); + $pos = strpos($file, '://'); if (!$pos) { $dirname = realpath(dirname($file)); From c0065a68b39879d728004ffce1f1e2b47f602b84 Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 14:39:39 +0000 Subject: [PATCH 10/23] Set new factories as internal --- src/Core/Logger/Factory/StreamLoggerFactory.php | 2 ++ src/Core/Logger/Factory/SyslogLoggerFactory.php | 2 ++ 2 files changed, 4 insertions(+) diff --git a/src/Core/Logger/Factory/StreamLoggerFactory.php b/src/Core/Logger/Factory/StreamLoggerFactory.php index 5a5b994f40..8119c40430 100644 --- a/src/Core/Logger/Factory/StreamLoggerFactory.php +++ b/src/Core/Logger/Factory/StreamLoggerFactory.php @@ -21,6 +21,8 @@ use Psr\Log\LoggerInterface; * The logger factory for the StreamLogger instance * * @see StreamLogger + * + * @internal */ final class StreamLoggerFactory implements LoggerFactory { diff --git a/src/Core/Logger/Factory/SyslogLoggerFactory.php b/src/Core/Logger/Factory/SyslogLoggerFactory.php index 44f9d79c73..24a884a5f9 100644 --- a/src/Core/Logger/Factory/SyslogLoggerFactory.php +++ b/src/Core/Logger/Factory/SyslogLoggerFactory.php @@ -19,6 +19,8 @@ use Psr\Log\LoggerInterface; * The logger factory for the SyslogLogger instance * * @see SyslogLogger + * + * @internal */ final class SyslogLoggerFactory implements LoggerFactory { From d410758cdde6d8763fc55d75fed40dce2d0da5df Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 14:40:44 +0000 Subject: [PATCH 11/23] Remove obsolet LegacyLoggerFactory --- .../Logger/Factory/LegacyLoggerFactory.php | 61 ------------------- .../Factory/LegacyLoggerFactoryTest.php | 36 ----------- 2 files changed, 97 deletions(-) delete mode 100644 src/Core/Logger/Factory/LegacyLoggerFactory.php delete mode 100644 tests/Unit/Core/Logger/Factory/LegacyLoggerFactoryTest.php diff --git a/src/Core/Logger/Factory/LegacyLoggerFactory.php b/src/Core/Logger/Factory/LegacyLoggerFactory.php deleted file mode 100644 index 2c7b6c0237..0000000000 --- a/src/Core/Logger/Factory/LegacyLoggerFactory.php +++ /dev/null @@ -1,61 +0,0 @@ -instanceCreator = $instanceCreator; - $this->config = $config; - $this->profiler = $profiler; - } - - /** - * Creates and returns a PSR-3 Logger instance. - * - * Calling this method multiple times with the same parameters SHOULD return the same object. - * - * @param \Psr\Log\LogLevel::* $logLevel The log level - * @param \Friendica\Core\Logger\Capability\LogChannel::* $logChannel The log channel - */ - public function createLogger(string $logLevel, string $logChannel): LoggerInterface - { - $factory = new Logger($logChannel); - - return $factory->create($this->instanceCreator, $this->config, $this->profiler); - } -} diff --git a/tests/Unit/Core/Logger/Factory/LegacyLoggerFactoryTest.php b/tests/Unit/Core/Logger/Factory/LegacyLoggerFactoryTest.php deleted file mode 100644 index 9ef920c71f..0000000000 --- a/tests/Unit/Core/Logger/Factory/LegacyLoggerFactoryTest.php +++ /dev/null @@ -1,36 +0,0 @@ -createStub(ICanCreateInstances::class), - $this->createStub(IManageConfigValues::class), - $this->createStub(Profiler::class), - ); - - $this->assertInstanceOf( - LoggerInterface::class, - $factory->createLogger(LogLevel::DEBUG, LogChannel::DEFAULT) - ); - } -} From 60ad014a6ed589380f944f7b58f00769f8bd9d48 Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 14:51:44 +0000 Subject: [PATCH 12/23] Hard-deprecation for now unused factory classes --- src/Core/Logger/Factory/AbstractLoggerTypeFactory.php | 4 ++++ src/Core/Logger/Factory/DelegatingLoggerFactory.php | 2 ++ src/Core/Logger/Factory/Logger.php | 4 ++++ src/Core/Logger/Factory/StreamLogger.php | 4 +++- src/Core/Logger/Factory/SyslogLogger.php | 4 +++- src/Core/Logger/Util/FileSystemUtil.php | 2 ++ 6 files changed, 18 insertions(+), 2 deletions(-) diff --git a/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php b/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php index 08a9559279..d2d606f65f 100644 --- a/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php +++ b/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php @@ -12,6 +12,8 @@ use Psr\Log\LogLevel; /** * Abstract class for creating logger types, which includes common necessary logic/content + * + * @deprecated 2025.02 Implement `\Friendica\Core\Logger\Factory\LoggerFactory` instead */ abstract class AbstractLoggerTypeFactory { @@ -25,6 +27,8 @@ abstract class AbstractLoggerTypeFactory */ public function __construct(IHaveCallIntrospections $introspection, string $channel) { + @trigger_error('Class `' . __CLASS__ . '` is deprecated since 2025.02 and will be removed after 5 months, implement `\Friendica\Core\Logger\Factory\LoggerFactory` instead.', E_USER_DEPRECATED); + $this->channel = $channel; $this->introspection = $introspection; } diff --git a/src/Core/Logger/Factory/DelegatingLoggerFactory.php b/src/Core/Logger/Factory/DelegatingLoggerFactory.php index 2091b51bd9..f0001132dd 100644 --- a/src/Core/Logger/Factory/DelegatingLoggerFactory.php +++ b/src/Core/Logger/Factory/DelegatingLoggerFactory.php @@ -15,6 +15,8 @@ use Psr\Log\NullLogger; /** * Delegates the creation of a logger based on config to other factories + * + * @internal */ final class DelegatingLoggerFactory implements LoggerFactory { diff --git a/src/Core/Logger/Factory/Logger.php b/src/Core/Logger/Factory/Logger.php index fbee580544..78451e713d 100644 --- a/src/Core/Logger/Factory/Logger.php +++ b/src/Core/Logger/Factory/Logger.php @@ -18,6 +18,8 @@ use Throwable; /** * The logger factory for the core logging instances + * + * @deprecated 2025.02 Implement `\Friendica\Core\Logger\Factory\LoggerFactory` instead */ class Logger { @@ -26,6 +28,8 @@ class Logger public function __construct(string $channel = LogChannel::DEFAULT) { + @trigger_error('Class `' . __CLASS__ . '` is deprecated since 2025.02 and will be removed after 5 months, implement `\Friendica\Core\Logger\Factory\LoggerFactory` instead.', E_USER_DEPRECATED); + $this->channel = $channel; } diff --git a/src/Core/Logger/Factory/StreamLogger.php b/src/Core/Logger/Factory/StreamLogger.php index b4fbe73dcc..b2c6de7f3e 100644 --- a/src/Core/Logger/Factory/StreamLogger.php +++ b/src/Core/Logger/Factory/StreamLogger.php @@ -20,7 +20,7 @@ use Psr\Log\NullLogger; /** * The logger factory for the StreamLogger instance * - * @deprecated 2025.02 Use `Friendica\Core\Logger\Factory\StreamLoggerFactory` instead + * @deprecated 2025.02 Implement `\Friendica\Core\Logger\Factory\LoggerFactory` instead * @see StreamLoggerFactory * @see StreamLoggerClass */ @@ -40,6 +40,8 @@ class StreamLogger extends AbstractLoggerTypeFactory */ public function create(IManageConfigValues $config, string $logfile = null, string $channel = null): LoggerInterface { + @trigger_error('Class `' . __CLASS__ . '` is deprecated since 2025.02 and will be removed after 5 months, implement `\Friendica\Core\Logger\Factory\LoggerFactory` instead.', E_USER_DEPRECATED); + $fileSystem = new FileSystem(); $logfile = $logfile ?? $config->get('system', 'logfile'); diff --git a/src/Core/Logger/Factory/SyslogLogger.php b/src/Core/Logger/Factory/SyslogLogger.php index f95dcb42ff..d9f98f05fd 100644 --- a/src/Core/Logger/Factory/SyslogLogger.php +++ b/src/Core/Logger/Factory/SyslogLogger.php @@ -16,7 +16,7 @@ use Psr\Log\LoggerInterface; /** * The logger factory for the SyslogLogger instance * - * @deprecated 2025.02 Use `Friendica\Core\Logger\Factory\SyslogLoggerFactory` instead + * @deprecated 2025.02 Implement `\Friendica\Core\Logger\Factory\LoggerFactory` instead * @see SyslogLoggerFactory * @see SyslogLoggerClass */ @@ -33,6 +33,8 @@ class SyslogLogger extends AbstractLoggerTypeFactory */ public function create(IManageConfigValues $config): LoggerInterface { + @trigger_error('Class `' . __CLASS__ . '` is deprecated since 2025.02 and will be removed after 5 months, implement `\Friendica\Core\Logger\Factory\LoggerFactory` instead.', E_USER_DEPRECATED); + $logOpts = $config->get('system', 'syslog_flags') ?? SyslogLoggerClass::DEFAULT_FLAGS; $logFacility = $config->get('system', 'syslog_facility') ?? SyslogLoggerClass::DEFAULT_FACILITY; $loglevel = SyslogLogger::mapLegacyConfigDebugLevel($config->get('system', 'loglevel')); diff --git a/src/Core/Logger/Util/FileSystemUtil.php b/src/Core/Logger/Util/FileSystemUtil.php index f4052b8c59..1c1bbc2726 100644 --- a/src/Core/Logger/Util/FileSystemUtil.php +++ b/src/Core/Logger/Util/FileSystemUtil.php @@ -11,6 +11,8 @@ use Friendica\Core\Logger\Exception\LoggerUnusableException; /** * interface for Util class for filesystem manipulation for Logger classes + * + * @internal */ interface FileSystemUtil { From 32b657b793ac6ffb1c8175987b20a55eef5abe25 Mon Sep 17 00:00:00 2001 From: Art4 Date: Mon, 14 Apr 2025 15:06:30 +0000 Subject: [PATCH 13/23] fix code style --- .../Logger/Factory/AbstractLoggerTypeFactory.php | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php b/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php index d2d606f65f..98c05e187c 100644 --- a/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php +++ b/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php @@ -48,21 +48,21 @@ abstract class AbstractLoggerTypeFactory // legacy WARNING case "0": return LogLevel::ERROR; - // legacy INFO + // legacy INFO case "1": return LogLevel::WARNING; - // legacy TRACE + // legacy TRACE case "2": return LogLevel::NOTICE; - // legacy DEBUG + // legacy DEBUG case "3": return LogLevel::INFO; - // legacy DATA + // legacy DATA case "4": - // legacy ALL + // legacy ALL case "5": return LogLevel::DEBUG; - // default if nothing set + // default if nothing set default: return $level; } From cd73f6a27b690e7fce61c598cf11a97ec0671503 Mon Sep 17 00:00:00 2001 From: Michael Date: Thu, 17 Apr 2025 20:13:03 +0000 Subject: [PATCH 14/23] Bluesky: Update actors regularly --- src/Protocol/ATProtocol/Processor.php | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/Protocol/ATProtocol/Processor.php b/src/Protocol/ATProtocol/Processor.php index d7a26f78cf..0d7505f6a8 100755 --- a/src/Protocol/ATProtocol/Processor.php +++ b/src/Protocol/ATProtocol/Processor.php @@ -327,7 +327,7 @@ class Processor private function getHeaderFromJetstream(stdClass $data, int $uid, int $protocol = Conversation::PARCEL_JETSTREAM): array { - $contact = $this->actor->getContactByDID($data->did, $uid, 0); + $contact = $this->actor->getContactByDID($data->did, $uid, 0, true); if (empty($contact)) { $this->logger->info('Contact not found for user', ['did' => $data->did, 'uid' => $uid]); return []; @@ -392,7 +392,7 @@ class Processor if (empty($post->author) || empty($post->cid) || empty($parts->rkey)) { return []; } - $contact = $this->actor->getContactByDID($post->author->did, $uid, 0); + $contact = $this->actor->getContactByDID($post->author->did, $uid, 0, true); if (empty($contact)) { $this->logger->info('Contact not found for user', ['did' => $post->author->did, 'uid' => $uid]); return []; From f840d1f582308d89e49c10d87c4eabb2872e14ca Mon Sep 17 00:00:00 2001 From: Marcus Funch Date: Sat, 26 Apr 2025 00:38:25 +0200 Subject: [PATCH 15/23] Frio: Fix bug making navigation tooltips disappear after scroll --- view/theme/frio/templates/nav.tpl | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/view/theme/frio/templates/nav.tpl b/view/theme/frio/templates/nav.tpl index 6aa876a002..37edb7118a 100644 --- a/view/theme/frio/templates/nav.tpl +++ b/view/theme/frio/templates/nav.tpl @@ -61,7 +61,7 @@ {{if $nav.network}} @@ -70,14 +70,14 @@ {{if $nav.channel}} {{/if}} {{if $nav.home}} {{/if}} {{if $nav.messages}} @@ -112,7 +112,7 @@ {{if $nav.contacts}}