sysPass/lib/SP/Util/VersionUtil.php

<?php
/*
 * sysPass
 *
 * @author nuxsmin
 * @link https://syspass.org
 * @copyright 2012-2020, Rubén Domínguez nuxsmin@$syspass.org
 *
 * This file is part of sysPass.
 *
 * sysPass is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * sysPass is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 *  along with sysPass.  If not, see <http://www.gnu.org/licenses/>.
 */

namespace SP\Util;

use SP\Services\Install\Installer;

/**
 * Class VersionUtil
 *
 * @package SP\Util
 */
final class VersionUtil
{
    /**
     * Devolver versión normalizada en cadena
     *
     * @return string
     */
    public static function getVersionStringNormalized(): string
    {
        return implode('', Installer::VERSION) . '.' . Installer::BUILD;
    }

    /**
     * Compare versions
     *
     * @param string       $currentVersion
     * @param array|string $upgradeableVersion
     *
     * @return bool True if $currentVersion is lower than $upgradeableVersion
     */
    public static function checkVersion(string $currentVersion, $upgradeableVersion): bool
    {
        if (is_array($upgradeableVersion)) {
            $upgradeableVersion = array_pop($upgradeableVersion);
        }

        $currentVersion = self::normalizeVersionForCompare($currentVersion);
        $upgradeableVersion = self::normalizeVersionForCompare($upgradeableVersion);

        if (empty($currentVersion) || empty($upgradeableVersion)) {
            return false;
        }

        if (PHP_INT_SIZE > 4) {
            return version_compare($currentVersion, $upgradeableVersion) === -1;
        }

        list($currentVersion, $build) = explode('.', $currentVersion, 2);
        list($upgradeVersion, $upgradeBuild) = explode('.', $upgradeableVersion, 2);

        $versionRes = (int)$currentVersion < (int)$upgradeVersion;

        return (($versionRes && (int)$upgradeBuild === 0)
            || ($versionRes && (int)$build < (int)$upgradeBuild));
    }

    /**
     * Return a normalized version string to be compared
     *
     * @param string|array $versionIn
     *
     * @return string
     */
    public static function normalizeVersionForCompare($versionIn): string
    {
        if (!empty($versionIn)) {
            if (is_string($versionIn)) {
                list($version, $build) = explode('.', $versionIn);
            } elseif (is_array($versionIn) && count($versionIn) === 4) {
                $version = implode('', array_slice($versionIn, 0, 3));
                $build = $versionIn[3];
            } else {
                return '';
            }

            $nomalizedVersion = 0;

            foreach (str_split($version) as $key => $value) {
                $nomalizedVersion += (int)$value * (10 ** (3 - $key));
            }

            return $nomalizedVersion . '.' . $build;
        }

        return '';
    }

    /**
     * @param string $version
     *
     * @return float|int
     */
    public static function versionToInteger(string $version)
    {
        $intVersion = 0;

        foreach (str_split(str_replace('.', '', $version)) as $key => $value) {
            $intVersion += (int)$value * (10 ** (3 - $key));
        }

        return $intVersion;
    }

    /**
     * Devuelve la versión de sysPass.
     *
     * @param bool $retBuild devolver el número de compilación
     *
     * @return array con el número de versión
     */
    public static function getVersionArray($retBuild = false): array
    {
        $version = array_values(Installer::VERSION);

        if ($retBuild === true) {
            $version[] = Installer::BUILD;

            return $version;
        }

        return $version;
    }

    /**
     * Devolver versión normalizada en array
     *
     * @return array
     */
    public static function getVersionArrayNormalized(): array
    {
        return [implode('', Installer::VERSION), Installer::BUILD];
    }
}