Hard-deprecation for now unused factory classes

diff --git a/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php b/src/Core/Logger/Factory/AbstractLoggerTypeFactory.php
index 08a9559279e7c33c4d1a9658f19f119e15c38523..d2d606f65f8142724fe6fe78677e96c6123aa0d3 100644 (file)
--- 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 2091b51bd995523ae59a269c7eea127105df824d..f0001132dd449946082e85b85386bf70e2b2361b 100644 (file)
--- 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 fbee5805440bc7a6c04963518e156b78eb709cfe..78451e713dfdf99f648e541333e163b0c6580030 100644 (file)
--- 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 b4fbe73dcc2e16e7c7ce67038777ffb5d8b6a8c5..b2c6de7f3e149909514d7f985760dcfafac1b7be 100644 (file)
--- 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 f95dcb42ffe16dcabf39bb901db91eb724da16cd..d9f98f05fd52de5a6f4b1f64ad7fa2691d465ce7 100644 (file)
--- 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 f4052b8c59eb9d3a723e7aedb258ea6cacae1823..1c1bbc2726b63ad17e0d385aed3beef9caeebc3a 100644 (file)
--- 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
 {