TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:24 +02:00
commit aad9daaefd
1506 changed files with 94005 additions and 0 deletions
@@ -0,0 +1,104 @@
+<?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!
+ */
+
+/*
+ * Inspired by and partially taken from the Neos.Form package (www.neos.io)
+ */
+
+namespace TYPO3\CMS\Form\ViewHelpers;
+
+use Psr\Http\Message\ServerRequestInterface;
+use TYPO3\CMS\Core\Utility\ArrayUtility;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Configuration\ConfigurationManagerInterface as ExtbaseConfigurationManagerInterface;
+use TYPO3\CMS\Extbase\Mvc\RequestInterface;
+use TYPO3\CMS\Form\Domain\Factory\ArrayFormFactory;
+use TYPO3\CMS\Form\Domain\Factory\FormFactoryInterface;
+use TYPO3\CMS\Form\Mvc\Persistence\FormPersistenceManagerInterface;
+use TYPO3Fluid\Fluid\Core\ViewHelper\AbstractViewHelper;
+
+/**
+ * Main Entry Point to render a Form into a Fluid Template
+ *
+ * Usage
+ * =====
+ *
+ * Default::
+ *
+ *    {namespace formvh=TYPO3\CMS\Form\ViewHelpers}
+ *    <formvh:render factoryClass="NameOfYourCustomFactoryClass" />
+ *
+ * The factory class must implement :php:`TYPO3\CMS\Form\Domain\Factory\FormFactoryInterface`.
+ *
+ * Scope: frontend
+ *
+ * @see https://docs.typo3.org/permalink/t3viewhelper:typo3-form-render
+ */
+final class RenderViewHelper extends AbstractViewHelper
+{
+    /**
+     * @var bool
+     */
+    protected $escapeOutput = false;
+
+    public function __construct(
+        private readonly FormPersistenceManagerInterface $formPersistenceManager,
+        private readonly ExtbaseConfigurationManagerInterface $extbaseConfigurationManager,
+    ) {}
+
+    public function initializeArguments(): void
+    {
+        $this->registerArgument('persistenceIdentifier', 'string', 'The persistence identifier for the form.');
+        $this->registerArgument('factoryClass', 'string', 'The fully qualified class name of the factory', false, ArrayFormFactory::class);
+        $this->registerArgument('prototypeName', 'string', 'Name of the prototype to use');
+        $this->registerArgument('overrideConfiguration', 'array', 'factory specific configuration', false, []);
+    }
+
+    public function render(): ?string
+    {
+        $persistenceIdentifier = $this->arguments['persistenceIdentifier'];
+        $prototypeName = $this->arguments['prototypeName'];
+        $overrideConfiguration = $this->arguments['overrideConfiguration'];
+        /** @var RequestInterface $request */
+        $request = $this->renderingContext->getAttribute(ServerRequestInterface::class);
+        // @todo: formvh:render() does not make sense without a persistenceIdentifier, does it?
+        if (!empty($persistenceIdentifier)) {
+            // The ConfigurationManager of ext:form needs ext:extbase ConfigurationManager to retrieve basic TS
+            // settings. ConfigurationManager of extbase should *usually* only be called in extbase context and
+            // needs a Request, which is usually set by extbase bootstrap.
+            // We are however (most likely) not in extbase context here.
+            // To prevent a fallback of extbase ConfigurationManager to $GLOBALS['TYPO3_REQUEST'], we set
+            // the request explicitly here, to then fetch $formSettings from ext:form ConfigurationManager.
+            // $typoScriptSettings is hand over to load() to apply TS overrides for single forms, see #92408.
+            $this->extbaseConfigurationManager->setRequest($request);
+            $typoScriptSettings = $this->extbaseConfigurationManager->getConfiguration(ExtbaseConfigurationManagerInterface::CONFIGURATION_TYPE_SETTINGS, 'form');
+            $formConfiguration = $this->formPersistenceManager->load($persistenceIdentifier, $typoScriptSettings, $request);
+            ArrayUtility::mergeRecursiveWithOverrule($formConfiguration, $overrideConfiguration);
+            $overrideConfiguration = $formConfiguration;
+            $overrideConfiguration['persistenceIdentifier'] = $persistenceIdentifier;
+        }
+        if (empty($prototypeName)) {
+            $prototypeName = $overrideConfiguration['prototypeName'] ?? 'standard';
+        }
+        // Even though getContainer() is internal, we can't get container injected here due to static scope
+        /** @var FormFactoryInterface $factory */
+        $factory = GeneralUtility::getContainer()->get($this->arguments['factoryClass']);
+        $formDefinition = $factory->build($overrideConfiguration, $prototypeName, $request);
+        $form = $formDefinition->bind($request);
+        return $form->render();
+    }
+}