9.5/_static_range_mapper_8php_source.html

<?php

declare(strict_types = 1);


namespace ‪TYPO3\CMS\Core\Routing\Aspect;


/*

 * 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!

 */


class ‪StaticRangeMapper implements ‪StaticMappableAspectInterface, \Countable

{

    protected ‪$settings;


    protected ‪$start;


    protected ‪$end;


    protected ‪$range;


    public function ‪__construct(array ‪$settings)

    {

        ‪$start = ‪$settings['start'] ?? null;

        ‪$end = ‪$settings['end'] ?? null;


        if (!is_string(‪$start)) {

            throw new \InvalidArgumentException('start must be string', 1537277163);

        }

        if (!is_string(‪$end)) {

            throw new \InvalidArgumentException('end must be string', 1537277164);

        }


        $this->settings = ‪$settings;

        $this->start = ‪$start;

        $this->end = ‪$end;

        $this->range = $this->‪applyNumericPrefix($this->‪buildRange());

    }


    public function ‪count(): int

    {

        return ‪count($this->range);

    }


    public function ‪generate(string $value): ?string

    {

        return $this->‪respondWhenInRange($value);

    }


    public function ‪resolve(string $value): ?string

    {

        return $this->‪respondWhenInRange($value);

    }


    protected function ‪respondWhenInRange(string $value): ?string

    {

        if (in_array($value, $this->range, true)) {

            return $value;

        }

        return null;

    }


    protected function ‪buildRange(): array

    {

        ‪$range = array_map('strval', range($this->start, $this->end));

        if (‪count(‪$range) > 1000) {

            throw new \LengthException(

                'Range is larger than 1000 items',

                1537696771

            );

        }

        return ‪$range;

    }


    protected function ‪applyNumericPrefix(array ‪$range): array

    {

        if (!preg_match('#^\d+$#', $this->start)

            || !preg_match('#^\d+$#', $this->end)

            || $this->start === '0' || $this->end === '0'

            || $this->start[0] !== '0' && $this->end[0] !== '0'

        ) {

            return ‪$range;

        }


        $length = strlen(max($this->start, $this->end));

        ‪$range = array_map(

            function ($value) use ($length) {

                return str_pad($value, $length, '0', STR_PAD_LEFT);

            },

            ‪$range

        );

        return ‪$range;

    }

}