O2System\Kernel\Http\Message\Uri\Path

Complexity

Total Complexity

43

Size/Duplication

Total Lines	266
Duplicated Lines	0 %

Importance

Changes	1
Bugs	0	Features	0

7 Methods

Rating	Name	Duplication	Size	Complexity
C	parseRequestUri()	0	43	12
A	getTotalSegments()	0	3	1
B	__construct()	0	27	8
A	removeRelativeDirectory()	0	21	6
A	setSegments()	0	26	5
A	parseQueryString()	0	19	5
A	filterSegment()	0	24	6

<?php
/**
 * This file is part of the O2System Framework package.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @author         Steeve Andrian Salim
 * @copyright      Copyright (c) Steeve Andrian Salim
 */

// ------------------------------------------------------------------------

namespace O2System\Kernel\Http\Message\Uri;

// ------------------------------------------------------------------------

use O2System\Spl\DataStructures\SplArrayObject;
use O2System\Spl\Exceptions\RuntimeException;

/**
 * Class Path
 *
 * @package O2System\Kernel\Http\Message\Uri
 */
class Path
{
    /**
     * Path::$string
     *
     * @var string
     */
    private $string;

    /**
     * Path::__construct
     *
     * @var array
     */
    private $segments;

    // ------------------------------------------------------------------------

    /**
     * Path::__construct
     *
     * @throws \O2System\Spl\Exceptions\RuntimeException
     */
    public function __construct()
    {
        if (function_exists('config')) {
            $protocol = strtoupper(config('uri')->offsetGet('protocol'));
        }

        empty($protocol) && $protocol = 'REQUEST_URI';

        switch ($protocol) {
            case 'AUTO':
            case 'REQUEST_URI':
                $this->string = $this->parseRequestUri();
                break;
            case 'QUERY_STRING':
                $this->string = $this->parseQueryString();
                break;
            case 'PATH_INFO':
            default:
                $this->string = isset($_SERVER[ $protocol ])
                    ? $_SERVER[ $protocol ]
                    : $this->parseRequestUri();
                break;
        }

        // Filter out control characters and trim slashes
        $this->string = trim(remove_invisible_characters($this->string, false), '/');
        $this->setSegments(explode('/', $this->string));
    }

    // ------------------------------------------------------------------------

    /**
     * Path::parseRequestUri
     *
     * Parse REQUEST_URI
     *
     * Will parse REQUEST_URI and automatically detect the URI from it,
     * while fixing the query string if necessary.
     *
     * @access  protected
     * @return  string
     */
    protected function parseRequestUri()
    {
        if ( ! isset($_SERVER[ 'REQUEST_URI' ], $_SERVER[ 'SCRIPT_NAME' ])) {
            return '';
        }

        $uri = parse_url($_SERVER[ 'REQUEST_URI' ]);
        $query = isset($uri[ 'query' ])
            ? $uri[ 'query' ]
            : '';
        $uri = isset($uri[ 'path' ])
            ? $uri[ 'path' ]
            : '';

        if (isset($_SERVER[ 'SCRIPT_NAME' ][ 0 ])) {
            if (strpos($uri, $_SERVER[ 'SCRIPT_NAME' ]) === 0) {
                $uri = (string)substr($uri, strlen($_SERVER[ 'SCRIPT_NAME' ]));
            } elseif (strpos($uri, dirname($_SERVER[ 'SCRIPT_NAME' ])) === 0) {
                $uri = (string)substr($uri, strlen(dirname($_SERVER[ 'SCRIPT_NAME' ])));
            }
        }

        // This section ensures that even on servers that require the URI to be in the query string (Nginx) a correct
        // URI is found, and also fixes the QUERY_STRING server var and $_GET array.
        if (trim($uri, '/') === '' AND strncmp($query, '/', 1) === 0) {
            $query = explode('?', $query, 2);
            $uri = $query[ 0 ];

            $_SERVER[ 'QUERY_STRING' ] = isset($query[ 1 ])
                ? $query[ 1 ]
                : '';
        } else {
            $_SERVER[ 'QUERY_STRING' ] = $query;
        }

        parse_str($_SERVER[ 'QUERY_STRING' ], $_GET);

        if ($uri === '/' || $uri === '') {
            return '/';
        }

        // Do some final cleaning of the URI and return it
        return $this->removeRelativeDirectory($uri);
    }

    // ------------------------------------------------------------------------

    /**
     * Path::removeRelativeDirectory
     *
     * Remove relative directory (../) and multi slashes (///)
     *
     * Do some final cleaning of the URI and return it, currently only used in self::parseRequestURI()
     *
     * @param   string $uri URI String
     *
     * @access  protected
     * @return  string
     */
    protected function removeRelativeDirectory($uri)
    {
        $segments = [];
        $segment = strtok($uri, '/');

        $base_dirs = explode('/', str_replace('\\', '/', PATH_ROOT));

The constant O2System\Kernel\Http\Message\Uri\PATH_ROOT was not found. Maybe you did not declare it correctly or list all dependencies?

        while ($segment !== false) {
            if (( ! empty($segment) || $segment === '0') AND
                $segment !== '..' AND
                ! in_array(
                    $segment,
                    $base_dirs
                )
            ) {
                $segments[] = $segment;
            }
            $segment = strtok('/');
        }

        return implode('/', $segments);
    }

    // ------------------------------------------------------------------------

    /**
     * Path::parseQueryString
     *
     * Parse QUERY_STRING
     *
     * Will parse QUERY_STRING and automatically detect the URI from it.
     *
     * @access  protected
     * @return  string
     */
    protected function parseQueryString()
    {
        $uri = isset($_SERVER[ 'QUERY_STRING' ])
            ? $_SERVER[ 'QUERY_STRING' ]
            : @getenv('QUERY_STRING');

        if (trim($uri, '/') === '') {
            return '';
        } elseif (strncmp($uri, '/', 1) === 0) {
            $uri = explode('?', $uri, 2);
            $_SERVER[ 'QUERY_STRING' ] = isset($uri[ 1 ])
                ? $uri[ 1 ]
                : '';
            $uri = rawurldecode($uri[ 0 ]);
        }

        parse_str($_SERVER[ 'QUERY_STRING' ], $_GET);

        return $this->removeRelativeDirectory($uri);
    }

    // --------------------------------------------------------------------

    /**
     * Path::setSegments
     *
     * @param array $segments
     *
     * @throws \O2System\Spl\Exceptions\RuntimeException
     */
    public function setSegments(array $segments)
    {
        $validSegments = [];

        if (count($segments)) {
            foreach ($segments as $key => $segment) {
                // Filter segments for security
                if ($segment = trim($this->filterSegment($segment))) {
                    if (false !== ($language = language()->registered($segment))) {

The assignment to $language is dead and can be removed.

The method registered() does not exist on O2System\Kernel\Services\Language.

                        language()->setDefault($segment);

                        continue;
                    } else {
                        $validSegments[] = $segment;
                    }
                }
            }
        }

        $validSegments = array_filter($validSegments);
        array_unshift($validSegments, null);

        unset($validSegments[ 0 ]);

        $this->segments = $validSegments;
        $this->string = implode('/', $this->segments);
    }

    // ------------------------------------------------------------------------

    /**
     * Path::filterSegment
     *
     * Filters segments for malicious characters.
     *
     * @param string $segment URI String
     *
     * @return mixed
     * @throws RuntimeException
     */
    protected function filterSegment($segment)
    {
        if (function_exists('config')) {
            $config = config('uri');
        } else {
            $config = new SplArrayObject([
                'permittedChars' => 'a-z 0-9~%.:_\-@#',
                'suffix'         => null,
            ]);
        }

        if ( ! empty($segment) AND
            ! empty($config->offsetGet('permittedChars')) AND
            ! preg_match('/^[' . $config->offsetGet('permittedChars') . ']+$/i', $segment) AND
            ! is_cli()
        ) {
            throw new RuntimeException('E_URI_HAS_DISALLOWED_CHARACTERS', 105);
        }

        // Convert programatic characters to entities and return
        return str_replace(
            ['$', '(', ')', '%28', '%29', $config->offsetGet('suffix')],    // Bad
            ['$', '(', ')', '(', ')', ''],    // Good
            $segment
        );
    }

    // ------------------------------------------------------------------------

    /**
     * Path::getTotalSegments
     *
     * @return int
     */
    public function getTotalSegments()
    {
        return count($this->segments);
    }
}