LegacyLinkNotationConverter.php

Go to the documentation of this file.

<?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\LinkHandling;
 
use ‪TYPO3\CMS\Core\Core\Environment;
use ‪TYPO3\CMS\Core\Resource\Exception\ResourceDoesNotExistException;
use ‪TYPO3\CMS\Core\Resource\File;
use ‪TYPO3\CMS\Core\Resource\Folder;
use ‪TYPO3\CMS\Core\Resource\ResourceFactory;
use ‪TYPO3\CMS\Core\Resource\ResourceInterface;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Core\Utility\MathUtility;
 
class ‪LegacyLinkNotationConverter
{
    protected ‪$resourceFactory;
 
    public function ‪resolve(string $linkParameter): array
    {
        $a = [];
        if (stripos(rawurldecode(trim($linkParameter)), 'phar://') === 0) {
            throw new \RuntimeException(
                'phar scheme not allowed as soft reference target',
                1530030673
            );
        }
 
        $result = [];
        // @todo If resolved result (linkDetails) are later used to build an uri using LinkBuilder->build(), it's needed
        //       to have the original $linkParameter in the result array. Otherwise, places may break like e.g. the
        //       DatabaseRecordLinkBuilder. Can we safely set this here directly and avoiding calls before build like
        //       "$linkDetails['typoLinkParameter'] = $redirectTarget;" - e.g. like in the ext:redirects
        //       TYPO3\CMS\Redirects\Service\RedirectService::resolveLinkDetailsFromLinkTarget() and other places.
 
        // Resolve FAL-api "file:UID-of-sys_file-record" and "file:combined-identifier"
        if (stripos($linkParameter, 'file:') === 0) {
            $result = $this->‪getFileOrFolderObjectFromMixedIdentifier(substr($linkParameter, 5));
        } elseif (GeneralUtility::validEmail((string)parse_url($linkParameter, PHP_URL_PATH))) {
            $result['type'] = ‪LinkService::TYPE_EMAIL;
            $result['email'] = $linkParameter;
        } elseif (str_starts_with($linkParameter, 'tel:')) {
            $result['type'] = ‪LinkService::TYPE_TELEPHONE;
            $result['telephone'] = $linkParameter;
        } elseif (str_contains($linkParameter, ':')) {
            // Check for link-handler keyword
            [$linkHandlerKeyword, $linkHandlerValue] = explode(':', $linkParameter, 2);
            $result['type'] = strtolower(trim($linkHandlerKeyword));
            if ($linkHandlerValue === '') {
                return [
                    'type' => ‪LinkService::TYPE_UNKNOWN,
                    'url' => $linkParameter,
                ];
            }
            $result['url'] = $linkParameter;
            $result['value'] = $linkHandlerValue;
            if ($result['type'] === ‪LinkService::TYPE_RECORD) {
                [$a['identifier'], $tableAndUid] = explode(':', $linkHandlerValue, 2);
                $tableAndUid = explode(':', $tableAndUid);
                if (count($tableAndUid) > 1) {
                    $a['table'] = $tableAndUid[0];
                    $a['uid'] = (int)$tableAndUid[1];
                } else {
                    // this case can happen if there is the very old linkhandler syntax, which was only record:<table>:<uid>
                    $a['table'] = $a['identifier'];
                    $a['uid'] = (int)$tableAndUid[0];
                }
                $result = array_merge($result, $a);
            }
        } else {
            // special handling without a scheme
            $isLocalFile = 0;
            $fileChar = (int)strpos($linkParameter, '/');
            $urlChar = (int)strpos($linkParameter, '.');
 
            $isIdOrAlias = ‪MathUtility::canBeInterpretedAsInteger($linkParameter);
            $matches = [];
            // capture old RTE links relative to TYPO3 Backend /typo3/
            if (preg_match('#../(?:index\\.php)?\\?id=([^&]+)#', $linkParameter, $matches)) {
                $linkParameter = $matches[1];
                $isIdOrAlias = true;
            }
            $containsSlash = false;
            if (!$isIdOrAlias) {
                // Detects if a file is found in site-root and if so it will be treated like a normal file.
                [$rootFileDat] = explode('?', rawurldecode($linkParameter));
                $containsSlash = str_contains($rootFileDat, '/');
                $pathInfo = pathinfo($rootFileDat);
                $fileExtension = strtolower($pathInfo['extension'] ?? '');
                if (!$containsSlash
                    && trim($rootFileDat)
                    && (
                        @is_file(‪Environment::getPublicPath() . '/' . $rootFileDat)
                        || $fileExtension === 'php'
                        || $fileExtension === 'html'
                        || $fileExtension === 'htm'
                    )
                ) {
                    $isLocalFile = 1;
                } elseif ($containsSlash) {
                    // Adding this so realurl directories are linked right (non-existing).
                    $isLocalFile = 2;
                }
            }
 
            // url (external): If doubleSlash or if a '.' comes before a '/'.
            if (!$isIdOrAlias && $isLocalFile !== 1 && $urlChar && (!$containsSlash || $urlChar < $fileChar)) {
                $result['type'] = ‪LinkService::TYPE_URL;
                $result['url'] = ‪UrlLinkHandler::getDefaultScheme() . '://' . $linkParameter;
                // file (internal) or folder
            } elseif ($containsSlash || $isLocalFile) {
                $result = $this->‪getFileOrFolderObjectFromMixedIdentifier($linkParameter);
            } else {
                // Integer or alias (alias is without slashes or periods or commas, that is
                // 'nospace,alphanum_x,lower,unique' according to definition in $GLOBALS['TCA']!)
                $result = $this->‪resolvePageRelatedParameters($linkParameter);
            }
        }
 
        return $result;
    }
 
    protected function ‪resolvePageRelatedParameters(string $data): array
    {
        $result = ['type' => ‪LinkService::TYPE_PAGE];
        if (str_contains($data, '#')) {
            [$data, $result['fragment']] = explode('#', $data, 2);
        }
        // check for additional parameters
        if (str_contains($data, '?')) {
            [$data, $result['parameters']] = explode('?', $data, 2);
        } elseif (str_contains($data, '&')) {
            [$data, $result['parameters']] = explode('&', $data, 2);
        }
        $data = rtrim($data, ',');
        if (empty($data)) {
            $result['pageuid'] = 'current';
        } elseif ($data[0] === '#') {
            $result['pageuid'] = 'current';
            $result['fragment'] = substr($data, 1);
        } elseif (str_contains($data, ',')) {
            [$result['pageuid'], $result['pagetype']] = explode(',', $data, 2);
        } elseif (str_contains($data, '/')) {
            $data = explode('/', trim($data, '/'));
            $result['pageuid'] = array_shift($data);
            foreach ($data as $k => $item) {
                if ($data[$k] % 2 === 0 && !empty($data[$k + 1])) {
                    $result['page' . $data[$k]] = $data[$k + 1];
                }
            }
        } else {
            $result['pageuid'] = $data;
        }
        if (‪MathUtility::canBeInterpretedAsInteger($result['pageuid'])) {
            $result['pageuid'] = (int)$result['pageuid'];
        }
        return $result;
    }
 
    protected function ‪getFileOrFolderObjectFromMixedIdentifier(string $mixedIdentifier): array
    {
        $result = [];
        try {
            $fileIdentifier = $mixedIdentifier;
            $fragment = null;
            if (str_contains($fileIdentifier, '#')) {
                [$fileIdentifier, $fragment] = explode('#', $fileIdentifier, 2);
            }
            $fileOrFolderObject = $this->‪getResourceFactory()->retrieveFileOrFolderObject($fileIdentifier);
            // Links to a file/folder in the main TYPO3 directory should not be considered as file links, but an external link
            if ($fileOrFolderObject instanceof ‪ResourceInterface && $fileOrFolderObject->‪getStorage()->getUid() === 0) {
                return [
                    'type' => ‪LinkService::TYPE_URL,
                    'url' => $mixedIdentifier,
                ];
            }
            // Link to a folder or file
            if ($fileOrFolderObject instanceof ‪File) {
                $result['type'] = ‪LinkService::TYPE_FILE;
                $result['file'] = $fileOrFolderObject;
                if ($fragment) {
                    $result['fragment'] = $fragment;
                }
            } elseif ($fileOrFolderObject instanceof ‪Folder) {
                $result['type'] = ‪LinkService::TYPE_FOLDER;
                $result['folder'] = $fileOrFolderObject;
                if ($fragment) {
                    $result['fragment'] = $fragment;
                }
            } elseif (str_starts_with($mixedIdentifier, '/')) {
                $result['type'] = ‪LinkService::TYPE_URL;
                $result['url'] = $mixedIdentifier;
            } else {
                $result['type'] = ‪LinkService::TYPE_UNKNOWN;
                $result['file'] = $mixedIdentifier;
            }
        } catch (\RuntimeException $e) {
            // Element wasn't found
            $result['type'] = ‪LinkService::TYPE_UNKNOWN;
            $result['file'] = $mixedIdentifier;
        } catch (‪ResourceDoesNotExistException $e) {
            // Resource was not found
            $result['type'] = ‪LinkService::TYPE_UNKNOWN;
            $result['file'] = $mixedIdentifier;
        }
 
        return $result;
    }
 
    protected function ‪getResourceFactory(): ‪ResourceFactory
    {
        if (!$this->resourceFactory) {
            $this->resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
        }
        return ‪$this->resourceFactory;
    }
}