TypeHandlingUtility.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\Extbase\Utility;
 
use ‪TYPO3\CMS\Core\Type\TypeInterface;
use ‪TYPO3\CMS\Extbase\Persistence\ObjectStorage;
use ‪TYPO3\CMS\Extbase\Utility\Exception\InvalidTypeException;
 
class ‪TypeHandlingUtility
{
    const ‪PARSE_TYPE_PATTERN = '/^\\\\?(?P<type>integer|int|float|double|boolean|bool|string|DateTimeImmutable|DateTime|[A-Z][a-zA-Z0-9\\\\]+|object|resource|array|ArrayObject|SplObjectStorage|TYPO3\\\\CMS\\\\Extbase\\\\Persistence\\\\ObjectStorage)(?:<\\\\?(?P<elementType>[a-zA-Z0-9\\\\]+)>)?/';
 
    const ‪LITERAL_TYPE_PATTERN = '/^(?:integer|int|float|double|boolean|bool|string)$/';
 
    protected static ‪$collectionTypes = ['array', \ArrayObject::class, \SplObjectStorage::class, ObjectStorage::class];
 
    public static function ‪parseType(string $type): array
    {
        $matches = [];
        if (preg_match(self::PARSE_TYPE_PATTERN, $type, $matches)) {
            $type = ‪self::normalizeType($matches['type']);
            $elementType = isset($matches['elementType']) ? ‪self::normalizeType($matches['elementType']) : null;
 
            if ($elementType !== null && !self::isCollectionType($type)) {
                throw new ‪InvalidTypeException('Found an invalid element type declaration in %s. Type "' . $type . '" must not have an element type hint (' . $elementType . ').', 1264093642);
            }
 
            return [
                'type' => $type,
                'elementType' => $elementType
            ];
        }
        throw new ‪InvalidTypeException('Found an invalid element type declaration in %s. A type "' . var_export($type, true) . '" does not exist.', 1264093630);
    }
 
    public static function ‪normalizeType(string $type): string
    {
        switch ($type) {
            case 'int':
                $type = 'integer';
                break;
            case 'bool':
                $type = 'boolean';
                break;
            case 'double':
                $type = 'float';
                break;
        }
        return $type;
    }
 
    public static function ‪isLiteral(string $type): bool
    {
        return preg_match(self::LITERAL_TYPE_PATTERN, $type) === 1;
    }
 
    public static function ‪isSimpleType(string $type): bool
    {
        return in_array(self::normalizeType($type), ['array', 'string', 'float', 'integer', 'boolean'], true);
    }
 
    public static function ‪isCoreType($type): bool
    {
        return is_subclass_of($type, TypeInterface::class);
    }
 
    public static function ‪isCollectionType(string $type): bool
    {
        if (in_array($type, self::$collectionTypes, true)) {
            return true;
        }
 
        if (class_exists($type) === true || interface_exists($type) === true) {
            foreach (self::$collectionTypes as $collectionType) {
                if (is_subclass_of($type, $collectionType) === true) {
                    return true;
                }
            }
        }
 
        return false;
    }
 
    public static function ‪isValidTypeForMultiValueComparison($value): bool
    {
        return is_iterable($value);
    }
 
    public static function ‪hex2bin(string $hexadecimalData): string
    {
        trigger_error(
            'Method ' . __METHOD__ . ' will be removed in TYPO3 11.0, use native hex2bin instead.',
            E_USER_DEPRECATED
        );
 
        $binaryData = '';
        $length = strlen($hexadecimalData);
        for ($i = 0; $i < $length; $i += 2) {
            $binaryData .= pack('C', hexdec(substr($hexadecimalData, $i, 2)));
        }
        return $binaryData;
    }
}