TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:38 +02:00
commit 4392dbe2ce
142 changed files with 11824 additions and 0 deletions
@@ -0,0 +1,110 @@
+<?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\Scheduler\Task;
+
+use Psr\Container\ContainerInterface;
+use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+use Symfony\Component\DependencyInjection\Exception\ServiceNotFoundException;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Scheduler\Exception\InvalidTaskException;
+use TYPO3\CMS\Scheduler\Execution;
+use TYPO3\CMS\Scheduler\Service\TaskService;
+
+/**
+ * Handles serialization of `AbstractTask` objects.
+ *
+ * @internal This is an internal API, avoid using it in custom implementations.
+ */
+#[Autoconfigure(public: true)]
+readonly class TaskSerializer
+{
+    public function __construct(
+        protected ContainerInterface $container,
+        protected TaskService $taskService,
+    ) {}
+
+    /**
+     * This method takes care of safely deserializing tasks from the database
+     * and either returns a valid Task or throws an InvalidTaskException, which
+     * holds information about the broken task.
+     *
+     * First, find the task object, from the registry
+     * Second, recreate the execution object,
+     * Then fill all the data of the new task object from the rest of the row.
+     *
+     * @throws InvalidTaskException
+     */
+    public function deserialize(array $row): AbstractTask
+    {
+        $taskType = $row['tasktype'] ?? '';
+        if (!empty($taskType)) {
+            if ($this->taskService->isTaskTypeRegistered($taskType)) {
+                $taskInformation = $this->taskService->getTaskDetailsFromTaskType($taskType);
+                $className = $taskInformation['className'];
+                try {
+                    $taskObject = $this->container->get($className);
+                } catch (ServiceNotFoundException) {
+                    $taskObject = GeneralUtility::makeInstance($className);
+                }
+            } else {
+                throw new InvalidTaskException('Task type ' . $taskType . ' not found. Probably not registered?', 1742584362);
+            }
+
+            if (!$taskObject instanceof AbstractTask) {
+                throw new InvalidTaskException('The deserialized task in not an instance of AbstractTask', 1642954501);
+            }
+            if ($taskObject instanceof ExecuteSchedulableCommandTask) {
+                $taskObject->setTaskType($taskType);
+            }
+            $taskObject->setTaskUid((int)$row['uid']);
+            $taskObject->setTaskGroup((int)$row['task_group']);
+            $taskParameters = json_decode($row['parameters'] ?? '', true) ?: [];
+            // Set additional fields from the row with the parameters stored
+            // in the parameters field for native types.
+            if ($taskInformation['isNativeTask'] ?? false) {
+                // If there are native registered fields, they take precedence over the values.
+                foreach ($taskInformation['additionalFields'] ?? [] as $additionalFieldName) {
+                    $taskParameters[$additionalFieldName] = $taskParameters[$additionalFieldName] ?? $row[$additionalFieldName] ?? null;
+                }
+            }
+            $taskObject->setTaskParameters($taskParameters);
+            $taskObject->setDescription((string)$row['description']);
+            $taskObject->setExecutionTime((int)$row['nextexecution']);
+            $taskObject->setTaskGroup((int)$row['task_group']);
+            $taskObject->setDisabled((bool)$row['disable']);
+            $executionDetails = json_decode($row['execution_details'] ?? '', true);
+            if ($executionDetails !== null) {
+                $taskObject->setExecution(Execution::createFromDetails($executionDetails));
+            }
+            return $taskObject;
+        }
+        throw new InvalidTaskException('No task type given for task ID : ' . $row['uid'], 1740514192);
+    }
+
+    /**
+     * If the task class couldn't be figured out from the unserialization (because of uninstalled extensions or exceptions),
+     * try to find it in the serialized string with a simple preg match.
+     */
+    public function extractClassName(string $serializedTask): ?string
+    {
+        if (preg_match('/^O:[0-9]+:"(?P<classname>[^"]+)"/', $serializedTask, $matches) === 1) {
+            return $matches['classname'];
+        }
+        return null;
+    }
+}