TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the TYPO3 CMS project.
+ *
+ * It is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License, either version 2
+ * of the License, or any later version.
+ *
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ *
+ * The TYPO3 project - inspiring people to share!
+ */
+
+namespace TYPO3\CMS\Core\Configuration;
+
+use Symfony\Component\DependencyInjection\Attribute\AsAlias;
+
+/**
+ * A lightweight API class to check if a feature is enabled.
+ *
+ * Features are simple options (true/false), and are stored in the
+ * global configuration array $TYPO3_CONF_VARS[SYS][features].
+ *
+ * For disabling or enabling a feature the "ConfigurationManager"
+ * should be used.
+ *
+ * -- Naming --
+ *
+ * Feature names should NEVER be named "enable" or have a negation, or contain versions or years
+ *    "enableFeatureXyz"
+ *    "disableOverlays"
+ *    "schedulerRevamped"
+ *    "useDoctrineQueries"
+ *    "disablePreparedStatements"
+ *    "disableHooksInFE"
+ *
+ * Proper namings for features
+ *    "ExtendedRichtextFormat"
+ *    "NativeYamlParser"
+ *    "InlinePageTranslations"
+ *    "TypoScriptParserIncludesAsXml"
+ *    "NativeDoctrineQueries"
+ *
+ * Ideally, these feature switches are added via the Install Tool or via FactoryConfiguration
+ * and can be used for Extensions as well.
+ *
+ * --- Usage ---
+ *
+ * if (GeneralUtility::makeInstance(Features::class)->isFeatureEnabled('InlineSvg')) {
+ *   ... do stuff here ...
+ * }
+ */
+#[AsAlias('features', public: true)]
+readonly class Features
+{
+    /**
+     * A list of features that are always activated (mainly happens if a previous feature switch is now always
+     * "turned on" to enforce a behaviour, but still valid for extension authors to ensure the feature switch
+     * returns "enabled" for future versions.
+     */
+    private const array ALWAYS_ACTIVE_FEATURES = [
+        // Enabled since v15.0 at any time.
+        'extbase.consistentDateTimeHandling',
+        // Enabled since v13.0 at any time.
+        'security.usePasswordPolicyForFrontendUsers',
+        'security.backend.enforceContentSecurityPolicy',
+        // Enabled since v12.0 at any time.
+        'subrequestPageErrors',
+        'yamlImportsFollowDeclarationOrder',
+        'security.frontend.htmlSanitizeParseFuncDefault',
+        'runtimeDbQuotingOfTcaConfiguration',
+        // Enabled since v11.0 at any time.
+        'fluidBasedPageModule',
+        // Enabled since v10.0 at any time.
+        'simplifiedControllerActionDispatching',
+        'unifiedPageTranslationHandling',
+        'felogin.extbase',
+    ];
+
+    /**
+     * Checks if a feature is active
+     *
+     * @param string $featureName the name of the feature
+     */
+    public function isFeatureEnabled(string $featureName): bool
+    {
+        if (in_array($featureName, self::ALWAYS_ACTIVE_FEATURES, true)) {
+            return true;
+        }
+        return isset($GLOBALS['TYPO3_CONF_VARS']['SYS']['features'][$featureName])
+            && $GLOBALS['TYPO3_CONF_VARS']['SYS']['features'][$featureName] === true;
+    }
+}