Subreality\Dilmun\Anshar\Http\UriParts\Port

Complexity

Total Complexity

13

Size/Duplication

Total Lines	98
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	0

Test Coverage

Coverage

100%

Importance

Changes	2
Bugs	0	Features	1

5 Methods

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

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

/**
 * Class Port
 * @package Subreality\Dilmun\Anshar\Http\UriParts
 */
class Port implements UriPartInterface
{
    protected $port = null;

    /**
     * Port constructor. Accepts an integer or null value representing a URI port component. Construction will throw an
     * exception if port is not an integer or is not null or if the given integer is outside of the allowed TCP/UDP
     * range of 1 to 65535.
     *
     * port = *DIGIT
     *
     * @see https://tools.ietf.org/html/rfc3986#appendix-A
     *
     * @throws \InvalidArgumentException if the given port is not an integer or null or if the given integer is out of
     * range
     *
     * @param int|null $port    A string representing a URI port
     */
    public function __construct($port)
    {
        if (!is_int($port) && !is_null($port)) {
            throw new \InvalidArgumentException("Port must be an integer or null");
        } elseif (!self::isValid($port)) {
            throw new \InvalidArgumentException("Port must be between 1 and 65535 inclusive");
        }

        $this->port = $port;
    }

    /**
     * Returns a string representation of the port.
     *
     * @return string   The string representation of the port
     */
    public function __toString()
    {
        return (string) $this->port;
    }

    /**
     * Validates a given port. A port is valid if it is either null or an integer between 1 and 65535 inclusive.
     *
     * @param mixed $port   The port to be validated
     * @return bool         Returns true if the given port is valid
     *                      Returns false otherwise
     */
    public static function isValid($port)
    {
        $port_valid = false;

        if (is_int($port)) {
            $port_valid = self::portIsInValidRange($port);
        } elseif (is_null($port)) {
            $port_valid = true;
        }

        return $port_valid;
    }

    /**
     * Returns a string representation of the port formatted so that it can be compiled into a complete URI string
     * per the Uri object's string specification.
     *
     * If the port is empty, toUriString returns an empty string; if the port is not empty, toUriString returns the
     * port prefixed with a colon.
     *
     * @see Uri::__toString
     *
     * @return string   A string representation of the port formatted for a complete URI string
     */
    public function toUriString()
    {
        $uri_string = (string) $this->port;

        if (!is_null($this->port)) {
            $uri_string = ":" . $uri_string;
        }

        return $uri_string;
    }

    /**
     * Validates whether a given port falls within the range of valid ports for TCP/UDP (1 to 65535)
     *
     * @param int $port The port to be validated
     *
     * @return bool     Returns true if the port falls within the valid range
     *                  Returns false otherwise
     */
    private static function portIsInValidRange($port)
    {
        if ($port > 0 && $port < 65536) {

The if-else statement can be simplified to return $port > 0 && $port < 65536;.

            return true;
        } else {
            return false;
        }
    }
}