trAvis - MANAGER

Edit File: Whip_VersionRequirement.php

<?php
/**
 * WHIP libary file.
 *
 * @package Yoast\WHIP
 */

/**
 * A value object containing a version requirement for a component version.
 */
class Whip_VersionRequirement implements Whip_Requirement {

/**
	 * The component name.
	 *
	 * @var string
	 */
	private $component;

/**
	 * The component version.
	 *
	 * @var string
	 */
	private $version;

/**
	 * The operator to use when comparing version.
	 *
	 * @var string
	 */
	private $operator;

/**
	 * Whip_Requirement constructor.
	 *
	 * @param string $component The component name.
	 * @param string $version   The component version.
	 * @param string $operator  The operator to use when comparing version.
	 */
	public function __construct( $component, $version, $operator = '=' ) {
		$this->validateParameters( $component, $version, $operator );

$this->component = $component;
		$this->version   = $version;
		$this->operator  = $operator;
	}

/**
	 * Retrieves the component name defined for the requirement.
	 *
	 * @return string The component name.
	 */
	public function component() {
		return $this->component;
	}

/**
	 * Gets the components version defined for the requirement.
	 *
	 * @return string
	 */
	public function version() {
		return $this->version;
	}

/**
	 * Gets the operator to use when comparing version numbers.
	 *
	 * @return string The comparison operator.
	 */
	public function operator() {
		return $this->operator;
	}

/**
	 * Creates a new version requirement from a comparison string.
	 *
	 * @param string $component        The component for this version requirement.
	 * @param string $comparisonString The comparison string for this version requirement.
	 *
	 * @return Whip_VersionRequirement The parsed version requirement.
	 *
	 * @throws Whip_InvalidVersionComparisonString When an invalid version comparison string is passed.
	 */
	public static function fromCompareString( $component, $comparisonString ) {

$matcher = '`
			(
				>=?     # Matches >= and >.
				|
				<=?     # Matches <= and <.
			)
			([^>=<\s]+) # Matches anything except >, <, =, and whitespace.
		`x';

if ( ! preg_match( $matcher, $comparisonString, $match ) ) {
			throw new Whip_InvalidVersionComparisonString( $comparisonString );
		}

$version  = $match[2];
		$operator = $match[1];

return new Whip_VersionRequirement( $component, $version, $operator );
	}

/**
	 * Validates the parameters passed to the requirement.
	 *
	 * @param string $component The component name.
	 * @param string $version   The component version.
	 * @param string $operator  The operator to use when comparing version.
	 *
	 * @throws Whip_EmptyProperty       When any of the parameters is empty.
	 * @throws Whip_InvalidOperatorType When the $operator parameter is invalid.
	 * @throws Whip_InvalidType         When any of the parameters is not of the expected type.
	 */
	private function validateParameters( $component, $version, $operator ) {
		if ( empty( $component ) ) {
			throw new Whip_EmptyProperty( 'Component' );
		}

if ( ! is_string( $component ) ) {
			throw new Whip_InvalidType( 'Component', $component, 'string' );
		}

if ( empty( $version ) ) {
			throw new Whip_EmptyProperty( 'Version' );
		}

if ( ! is_string( $version ) ) {
			throw new Whip_InvalidType( 'Version', $version, 'string' );
		}

if ( empty( $operator ) ) {
			throw new Whip_EmptyProperty( 'Operator' );
		}

if ( ! is_string( $operator ) ) {
			throw new Whip_InvalidType( 'Operator', $operator, 'string' );
		}

$validOperators = array( '=', '==', '===', '<', '>', '<=', '>=' );
		if ( ! in_array( $operator, $validOperators, true ) ) {
			throw new Whip_InvalidOperatorType( $operator, $validOperators );
		}
	}
}