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,95 @@
+<?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\Resource;
+
+use TYPO3\CMS\Core\Core\Environment;
+use TYPO3\CMS\Core\Utility\PathUtility;
+
+/**
+ * Model representing an absolute or relative path in the local file system
+ * @internal
+ */
+class LocalPath
+{
+    public const TYPE_ABSOLUTE = 1;
+    public const TYPE_RELATIVE = 2;
+
+    protected string $raw;
+    protected ?string $relative = null;
+    protected string $absolute;
+    protected int $type;
+
+    public function __construct(string $value, int $type)
+    {
+        if ($type !== self::TYPE_ABSOLUTE && $type !== self::TYPE_RELATIVE) {
+            throw new \LogicException(sprintf('Unexpected type "%d"', $type), 1625826491);
+        }
+
+        // @todo `../` is erased here, check again if this is a valid scenario
+        // value and absolute have leading and trailing slash, e.g. '/some/path/'
+        $value = '/' . trim(PathUtility::getCanonicalPath($value), '/');
+        $value .= $value !== '/' ? '/' : '';
+        $this->raw = $value;
+        $this->type = $type;
+
+        $publicPath = Environment::getPublicPath();
+        if ($type === self::TYPE_RELATIVE) {
+            $this->relative = $value;
+            $this->absolute = PathUtility::getCanonicalPath($publicPath . $value) . '/';
+        } elseif ($type === self::TYPE_ABSOLUTE) {
+            $this->absolute = $value;
+            $this->relative = str_starts_with($value, $publicPath)
+                ? substr($value, strlen($publicPath))
+                : null;
+        }
+    }
+
+    /**
+     * @return string normalized path as provided
+     */
+    public function getRaw(): string
+    {
+        return $this->raw;
+    }
+
+    /**
+     * @return string|null (calculated) relative path to public path - `null` if outside public path
+     */
+    public function getRelative(): ?string
+    {
+        return $this->relative;
+    }
+
+    /**
+     * @return string (calculated) absolute path
+     */
+    public function getAbsolute(): string
+    {
+        return $this->absolute;
+    }
+
+    public function isAbsolute(): bool
+    {
+        return $this->type === self::TYPE_ABSOLUTE;
+    }
+
+    public function isRelative(): bool
+    {
+        return $this->type === self::TYPE_RELATIVE;
+    }
+}