Uri.php

Go to the documentation of this file.

<?php
 
/*
 * 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\Http;
 
use Psr\Http\Message\UriInterface;
use ‪TYPO3\CMS\Core\Utility\MathUtility;
 
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 "' . $uri . '" 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 (‪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) {
            [$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
        );
    }
}