Subreality\Dilmun\Anshar\Http\UriParts\Scheme

Complexity

Total Complexity

8

Size/Duplication

Total Lines	62
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	0

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	10	4
A	__toString()	0	4	1
A	isValid()	0	4	1
A	toUriString()	0	10	2

<?php
namespace Subreality\Dilmun\Anshar\Http\UriParts;

/**
 * Class Scheme
 * @package Subreality\Dilmun\Anshar\Http\UriParts
 */
class Scheme
{
    private static $valid_pattern = '/^[a-z][\w\+\-\.]*$/i';

    private $scheme = "";

    /**
     * Scheme constructor. Accepts a string representing a URI scheme. Construction will throw an exception if the
     * scheme is either not a string or does not conform to the RFC3986 URI scheme specification.
     *
     * scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )
     *
     * @see https://tools.ietf.org/html/rfc3986#appendix-A
     *
     * @throws \InvalidArgumentException
     *
     * @param string $scheme    A string representing a URI scheme
     */
    public function __construct($scheme)
    {
        if (!is_string($scheme)) {
            throw new \InvalidArgumentException("Scheme must be a string");
        } elseif (!empty($scheme) && !$this->isValid($scheme)) {
            throw new \InvalidArgumentException("Scheme must conform to RFC3986 specification");
        }

        $this->scheme = $scheme;
    }

    public function __toString()
    {
        return $this->scheme;
    }

    /**
     * Determines whether a given scheme adheres to the RFC3986 specification:
     *
     * scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )
     *
     * @see https://tools.ietf.org/html/rfc3986#appendix-A
     * @see Scheme::$valid_pattern
     *
     * @param string $scheme    The scheme to check for validity
     * @return bool             Returns true if the provided scheme matches the RFC3986 specification
     *                          Returns false otherwise
     */
    public static function isValid($scheme)
    {
        return (bool) preg_match(self::$valid_pattern, $scheme);
    }

    public function toUriString()
    {
        $uri_scheme = $this->scheme;

        if (!empty($this->scheme)) {
            $uri_scheme .= ":";
        }

        return $uri_scheme;
    }
}