9.5/_uri_8php_source.html

<?php

namespace ‪TYPO3\CMS\Core\Http;


/*

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

 */


use Psr\Http\Message\UriInterface;


class ‪Uri implements UriInterface

{

    const ‪SUBDELIMITER_CHARLIST = '!\$&\'\‍(\‍)\*\+,;=';


    const ‪UNRESERVED_CHARLIST = 'a-zA-Z0-9_\-\.~';


    protected ‪$scheme;


    protected ‪$supportedSchemes = [

        'http'  => 80,

        'https' => 443

    ];


    protected ‪$authority = '';


    protected ‪$userInfo = '';


    protected ‪$host = '';


    protected ‪$port;


    protected ‪$path = '';


    protected ‪$query = '';


    protected ‪$fragment;


    public function ‪__construct($uri = '')

    {

        if (!is_string($uri)) {

            $argumentType = is_object($uri) ? get_class($uri) : gettype($uri);

            throw new \InvalidArgumentException('URI passed must be a string, but is of type "' . $argumentType . '"', 1436717320);

        }

        if (!empty($uri)) {

            $this->‪parseUri($uri);

        }

    }


    protected function ‪parseUri($uri)

    {

        $uriParts = parse_url($uri);


        if ($uriParts === false) {

            throw new \InvalidArgumentException('The parsedUri string appears to be malformed', 1436717322);

        }


        if (isset($uriParts['scheme'])) {

            $this->scheme = $this->‪sanitizeScheme($uriParts['scheme']);

        }


        if (isset($uriParts['user'])) {

            $this->userInfo = $uriParts['user'];

            if (isset($uriParts['pass'])) {

                $this->userInfo .= ':' . $uriParts['pass'];

            }

        }


        if (isset($uriParts['host'])) {

            $this->host = $uriParts['host'];

        }


        if (isset($uriParts['port'])) {

            $this->port = (int)$uriParts['port'];

        }


        if (isset($uriParts['path'])) {

            $this->path = $this->‪sanitizePath($uriParts['path']);

        }


        if (isset($uriParts['query'])) {

            $this->query = $this->‪sanitizeQuery($uriParts['query']);

        }


        if (isset($uriParts['fragment'])) {

            $this->fragment = $this->‪sanitizeFragment($uriParts['fragment']);

        }

    }


    public function ‪getScheme()

    {

        return ‪$this->scheme;

    }


    public function ‪getAuthority()

    {

        if (empty($this->host)) {

            return '';

        }


        ‪$authority = ‪$this->host;

        if (!empty($this->userInfo)) {

            ‪$authority = $this->userInfo . '@' . ‪$authority;

        }


        if ($this->‪isNonStandardPort($this->scheme, $this->host, $this->port)) {

            ‪$authority .= ':' . ‪$this->port;

        }


        return ‪$authority;

    }


    public function ‪getUserInfo()

    {

        return ‪$this->userInfo;

    }


    public function ‪getHost()

    {

        return ‪$this->host;

    }


    public function ‪getPort()

    {

        return $this->‪isNonStandardPort($this->scheme, $this->host, $this->port) ? $this->port : null;

    }


    public function ‪getPath()

    {

        return ‪$this->path;

    }


    public function ‪getQuery()

    {

        return ‪$this->query;

    }


    public function ‪getFragment()

    {

        return ‪$this->fragment;

    }


    public function ‪withScheme(‪$scheme)

    {

        ‪$scheme = $this->‪sanitizeScheme(‪$scheme);


        $clonedObject = clone $this;

        $clonedObject->scheme = ‪$scheme;

        return $clonedObject;

    }


    public function ‪withUserInfo($user, $password = null)

    {

        ‪$userInfo = $user;

        if (!empty($password)) {

            ‪$userInfo .= ':' . $password;

        }


        $clonedObject = clone $this;

        $clonedObject->userInfo = ‪$userInfo;

        return $clonedObject;

    }


    public function ‪withHost(‪$host)

    {

        $clonedObject = clone $this;

        $clonedObject->host = ‪$host;

        return $clonedObject;

    }


    public function ‪withPort(‪$port)

    {

        if (‪$port !== null) {

            if (\‪TYPO3\CMS\Core\Utility\MathUtility::canBeInterpretedAsInteger(‪$port) === false) {

                $argumentType = is_object(‪$port) ? get_class(‪$port) : gettype(‪$port);

                throw new \InvalidArgumentException('Invalid port "' . $argumentType . '" specified, must be an integer.', 1436717324);

            }


            ‪$port = (int)‪$port;

            if ($port < 1 || $port > 65535) {

                throw new \InvalidArgumentException('Invalid port "' . ‪$port . '" specified, must be a valid TCP/UDP port.', 1436717326);

            }

        }


        $clonedObject = clone $this;

        $clonedObject->port = ‪$port;

        return $clonedObject;

    }


    public function ‪withPath(‪$path)

    {

        if (!is_string(‪$path)) {

            throw new \InvalidArgumentException('Invalid path provided. Must be of type string.', 1436717328);

        }


        if (strpos(‪$path, '?') !== false) {

            throw new \InvalidArgumentException('Invalid path provided. Must not contain a query string.', 1436717330);

        }


        if (strpos(‪$path, '#') !== false) {

            throw new \InvalidArgumentException('Invalid path provided; must not contain a URI fragment', 1436717332);

        }


        ‪$path = $this->‪sanitizePath(‪$path);

        $clonedObject = clone $this;

        $clonedObject->path = ‪$path;

        return $clonedObject;

    }


    public function ‪withQuery(‪$query)

    {

        if (!is_string(‪$query)) {

            throw new \InvalidArgumentException('Query string must be a string.', 1436717334);

        }


        if (strpos(‪$query, '#') !== false) {

            throw new \InvalidArgumentException('Query string must not include a URI fragment.', 1436717336);

        }


        ‪$query = $this->‪sanitizeQuery(‪$query);

        $clonedObject = clone $this;

        $clonedObject->query = ‪$query;

        return $clonedObject;

    }


    public function ‪withFragment(‪$fragment)

    {

        ‪$fragment = $this->‪sanitizeFragment(‪$fragment);

        $clonedObject = clone $this;

        $clonedObject->fragment = ‪$fragment;

        return $clonedObject;

    }


    public function ‪__toString()

    {

        $uri = '';


        if (!empty($this->scheme)) {

            $uri .= $this->scheme . ':';

        }


        ‪$authority = $this->‪getAuthority();

        if (!empty(‪$authority)) {

            $uri .= '//' . ‪$authority;

        }


        ‪$path = $this->‪getPath();

        if (!empty(‪$path)) {

            $uri .= '/' . ltrim(‪$path, '/');

        }


        if ($this->query) {

            $uri .= '?' . ‪$this->query;

        }

        if ($this->fragment) {

            $uri .= '#' . ‪$this->fragment;

        }

        return $uri;

    }


    protected function ‪isNonStandardPort(‪$scheme, ‪$host, ‪$port)

    {

        if (empty(‪$scheme)) {

            return empty(‪$host) || !empty(‪$port);

        }


        if (empty(‪$host) || empty(‪$port)) {

            return false;

        }


        return !isset($this->supportedSchemes[‪$scheme]) || ‪$port !== $this->supportedSchemes[‪$scheme];

    }


    protected function ‪sanitizeScheme(‪$scheme)

    {

        ‪$scheme = strtolower(‪$scheme);

        ‪$scheme = preg_replace('#:(//)?$#', '', ‪$scheme);


        if (empty(‪$scheme)) {

            return '';

        }


        if (!array_key_exists(‪$scheme, $this->supportedSchemes)) {

            throw new \InvalidArgumentException('Unsupported scheme "' . ‪$scheme . '"; must be any empty string or in the set (' . implode(', ', array_keys($this->supportedSchemes)) . ')', 1436717338);

        }


        return ‪$scheme;

    }


    protected function ‪sanitizePath(‪$path)

    {

        return preg_replace_callback(

            '/(?:[^' . self::UNRESERVED_CHARLIST . ':@&=\+\$,\/;%]+|%(?![A-Fa-f0-9]{2}))/',

            function ($matches) {

                return rawurlencode($matches[0]);

            },

            ‪$path

        );

    }


    protected function ‪sanitizeQuery(‪$query)

    {

        if (!empty(‪$query) && strpos(‪$query, '?') === 0) {

            ‪$query = substr(‪$query, 1);

        }


        $parts = explode('&', ‪$query);

        foreach ($parts as $index => $part) {

            list($key, $value) = $this->‪splitQueryValue($part);

            if ($value === null) {

                $parts[$index] = $this->‪sanitizeQueryOrFragment($key);

                continue;

            }

            $parts[$index] = $this->‪sanitizeQueryOrFragment($key) . '=' . $this->‪sanitizeQueryOrFragment($value);

        }


        return implode('&', $parts);

    }


    protected function ‪splitQueryValue($value)

    {

        $data = explode('=', $value, 2);

        if (count($data) === 1) {

            $data[] = null;

        }

        return $data;

    }


    protected function ‪sanitizeFragment(‪$fragment)

    {

        if (‪$fragment === null) {

            ‪$fragment = '';

        }


        if (!empty(‪$fragment) && strpos(‪$fragment, '#') === 0) {

            ‪$fragment = substr(‪$fragment, 1);

        }


        return $this->‪sanitizeQueryOrFragment(‪$fragment);

    }


    protected function ‪sanitizeQueryOrFragment($value)

    {

        return preg_replace_callback(

            '/(?:[^' . self::UNRESERVED_CHARLIST . self::SUBDELIMITER_CHARLIST . '%:@\/\?]+|%(?![A-Fa-f0-9]{2}))/',

            function ($matches) {

                return rawurlencode($matches[0]);

            },

            $value

        );

    }

}