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,52 @@
+<?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\Html;
+
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\HtmlSanitizer\Builder\BuilderInterface;
+
+/**
+ * Factory for creating a (sanitizer) builder instance. Corresponding presets can
+ * be declared in `$GLOBALS['TYPO3_CONF_VARS']['SYS']['htmlSanitizer']` like e.g.
+ *
+ * ```
+ * $GLOBALS['TYPO3_CONF_VARS']['SYS']['htmlSanitizer'] = [
+ *   'default' => \TYPO3\CMS\Core\Html\DefaultSanitizerBuilder::class,
+ *   'custom' => \Vendor\Package\CustomBuilder::class,
+ * ];
+ * ```
+ *
+ * @internal
+ */
+final readonly class SanitizerBuilderFactory
+{
+    public function build(string $identifier): BuilderInterface
+    {
+        if (empty($GLOBALS['TYPO3_CONF_VARS']['SYS']['htmlSanitizer'][$identifier])) {
+            throw new \LogicException(sprintf('Undefined `htmlSanitizer` identifier `%s`', $identifier), 1624876139);
+        }
+        $builder = GeneralUtility::makeInstance($GLOBALS['TYPO3_CONF_VARS']['SYS']['htmlSanitizer'][$identifier]);
+        if (!$builder instanceof BuilderInterface) {
+            throw new \LogicException(
+                sprintf('Builder `%s` must implement interface `%s`', get_class($builder), BuilderInterface::class),
+                1624876266
+            );
+        }
+        return $builder;
+    }
+}