<?php

/**

 * Port utilities for Requests

 *

 * @package Requests\Utilities

 * @since   2.0.0

 */

namespace WpOrg\Requests;

use WpOrg\Requests\Exception;

use WpOrg\Requests\Exception\InvalidArgument;

/**

 * Find the correct port depending on the Request type.

 *

 * @package Requests\Utilities

 * @since   2.0.0

 */

final class Port {

	/**

	 * Port to use with Acap requests.

	 *

	 * @var int

	 */

	const ACAP = 674;

	/**

	 * Port to use with Dictionary requests.

	 *

	 * @var int

	 */

	const DICT = 2628;

	/**

	 * Port to use with HTTP requests.

	 *

	 * @var int

	 */

	const HTTP = 80;

	/**

	 * Port to use with HTTP over SSL requests.

	 *

	 * @var int

	 */

	const HTTPS = 443;

	/**

	 * Retrieve the port number to use.

	 *

	 * @param string $type Request type.

	 *                     The following requests types are supported:

	 *                     'acap', 'dict', 'http' and 'https'.

	 *

	 * @return int

	 *

	 * @throws \WpOrg\Requests\Exception\InvalidArgument When a non-string input has been passed.

	 * @throws \WpOrg\Requests\Exception                 When a non-supported port is requested ('portnotsupported').

	 */

	public static function get($type) {

		if (!is_string($type)) {

			throw InvalidArgument::create(1, '$type', 'string', gettype($type));

		}

		$type = strtoupper($type);

		if (!defined("self::{$type}")) {

			$message = sprintf('Invalid port type (%s) passed', $type);

			throw new Exception($message, 'portnotsupported');

		}

		return constant("self::{$type}");

	}

}