TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:28 +02:00
commit 3a4ca58ca1
90 changed files with 9646 additions and 0 deletions
@@ -0,0 +1,99 @@
+<?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\Impexp\Utility;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+use TYPO3\CMS\Core\Log\LogManager;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Impexp\Event\BeforeImportEvent;
+use TYPO3\CMS\Impexp\Import;
+
+/**
+ * Utility for import / export
+ * Can be used for API access for simple importing of files.
+ *
+ * @internal This class is not considered part of the public TYPO3 API.
+ */
+#[Autoconfigure(public: true)]
+class ImportExportUtility
+{
+    protected ?Import $import = null;
+    protected EventDispatcherInterface $eventDispatcher;
+    protected bool $importSiteConfigurations = true;
+
+    public function __construct(EventDispatcherInterface $eventDispatcher)
+    {
+        $this->eventDispatcher = $eventDispatcher;
+    }
+
+    public function getImport(): ?Import
+    {
+        return $this->import;
+    }
+
+    public function disableSiteConfigurationImport(): void
+    {
+        $this->importSiteConfigurations = false;
+    }
+
+    /**
+     * Import a T3D file directly
+     *
+     * @param string $file The full absolute path to the file
+     * @param int $pid The pid under which the t3d file should be imported
+     * @throws \ErrorException
+     * @return int ID of first created page
+     */
+    public function importT3DFile(string $file, int $pid): int
+    {
+        $this->import = GeneralUtility::makeInstance(Import::class);
+        $this->import->setPid($pid);
+        if (!$this->importSiteConfigurations) {
+            $this->import->disableSiteConfigurationImport();
+        }
+
+        $this->eventDispatcher->dispatch(new BeforeImportEvent($this->import, $file));
+
+        try {
+            $this->import->loadFile($file);
+            $this->import->importData();
+        } catch (\Exception $e) {
+            $logger = GeneralUtility::makeInstance(LogManager::class)->getLogger(__CLASS__);
+            $logger->warning(
+                $e->getMessage() . PHP_EOL . implode(PHP_EOL, $this->import->getErrorLog())
+            );
+        }
+
+        // Get id of first created page:
+        $importResponse = 0;
+        $importMapId = $this->import->getImportMapId();
+        if (isset($importMapId['pages'])) {
+            $newPages = $importMapId['pages'];
+            $importResponse = (int)reset($newPages);
+        }
+
+        // Check for errors during the import process:
+        if ($this->import->hasErrors()) {
+            if (!$importResponse) {
+                throw new \ErrorException('No page records imported', 1377625537);
+            }
+        }
+        return $importResponse;
+    }
+}