EVOLUTION-MANAGER
Edit File: class-fontawesome-preference-conflict-detector.php
<?php namespace FortAwesome; /** * Class FontAwesome_Preference_Conflict_Detector */ class FontAwesome_Preference_Conflict_Detector { protected static function resolve_version( $configured_option, $current_preference, $latest_version_5, $latest_version_6 ) { /** * If the version given as configured_option is 'latest', '5.x', or '6.x', as it may be for * a kit, then we'll resolve that symbolic version into whatever is the corresponding semantic version. * The symbolic version "latest" has been deprecated, and is defined to mean the same as "5.x", * so it is not the *absolutely* latest, just the latest 5.x. */ $symbolic_versions = array( 'latest' => $latest_version_5, '5.x' => $latest_version_5, '6.x' => $latest_version_6, ); $resolved_version = ( is_string( $configured_option ) && isset( $symbolic_versions[ $configured_option ] ) ) ? $symbolic_versions[ $configured_option ] : $configured_option; return self::version_satisfies( $resolved_version, $current_preference ); } /** * Because all of our options currently require strict equality, all or nothing, to be considered "satisfied" or * non-conflicted, except for version: * Use function_exists to see if something like resolve_$option exists, if not, assume equality. * If it does, then delegate to it. We would need to delegate to it for the version option, because * clients should be able to specify an expression to represent version compatibility. * * The $latest_version_5 and $latest_version_6 params will be passed as the third argument to any resolver * functions, and should be set to the actual version numbers of the corresponding latest versions known, * like '5.12.0', not the word 'latest'. These are the values that can be used * when checking whether a version preference is satisfied when 'latest', '5.x', or '6.x' is the * configured version in a kit. * * Internal use only. Not part of this plugin's public API. * * @internal * @ignore * @since 4.0.0 */ public static function detect( $configured_options = array(), $client_preferences = array(), $latest_version_5 = null, $latest_version_6 = null ) { return array_reduce( array_keys( $configured_options ), function( $carry, $option ) use ( $configured_options, $client_preferences, $latest_version_5, $latest_version_6 ) { $resolve_method_candidate = 'resolve_' . $option; if ( isset( $client_preferences[ $option ] ) ) { if ( method_exists( __CLASS__, $resolve_method_candidate ) ) { return call_user_func( array( __CLASS__, $resolve_method_candidate ), $configured_options[ $option ], $client_preferences[ $option ], $latest_version_5, $latest_version_6 ) ? $carry : array_merge( $carry, array( $option ) ); } else { return $configured_options[ $option ] === $client_preferences[ $option ] ? $carry : array_merge( $carry, array( $option ) ); } } else { return $carry; } }, array() ); } /** * Reports whether the given version satisfies the given constraints. * * Internal use only, not part of this plugin's public API. * * This is really just a generalized utility function, instead of incorporating a full-blown semver library. * * The constraints array should contain one element per constraint, where each individual constraint is itself * an array of arguments that can be passed as the second and third arguments to the standard `version_compare` * function. * * The constraints will be ANDed together. * * For example the following constraints... * * ```php * array( * [ '1.0.0', '>='], * [ '2.0.0', '<'] * ) * ``` * * ...mean: "assert that the given $version is greater than or equal 1.0.0 AND strictly less than 2.0.0" * * To express OR conditions, make multiple calls to this function and OR the results together in your own code. * * @link http://php.net/manual/en/function.version-compare.php * @param string $version * @param array $constraints * @ignore * @internal * @throws ClientPreferencesSchemaException * @return bool */ public static function version_satisfies( $version, $constraints ) { $valid_operators = array( '<', 'lt', '<=', 'le', '>', 'gt', '>=', 'ge', '==', '=', 'eq', '!=', '<>', 'ne' ); if ( ! is_array( $constraints ) ) { throw new ClientPreferencesSchemaException(); } $result_so_far = true; foreach ( $constraints as $constraint ) { if ( ! is_array( $constraint ) || 2 !== count( $constraint ) || false === array_search( $constraint[1], $valid_operators, true ) ) { throw new ClientPreferencesSchemaException(); } if ( ! version_compare( $version, $constraint[0], $constraint[1] ) ) { $result_so_far = false; break; } } return $result_so_far; } }