119 lines
4.5 KiB
PHP
119 lines
4.5 KiB
PHP
<?php
|
|
/*
|
|
* Copyright (c) 2020-2021 Антон Аксенов (Anthony Axenov)
|
|
*
|
|
* This code is licensed under MIT.
|
|
* Этот код распространяется по лицензии MIT.
|
|
* https://github.com/anthonyaxenov/atol-online/blob/master/LICENSE
|
|
*/
|
|
|
|
namespace AtolOnline;
|
|
|
|
/**
|
|
* Класс с функциями-хелперами
|
|
*/
|
|
final class Helpers
|
|
{
|
|
/**
|
|
* Конвертирует копейки в рубли, оставляя только 2 знака после запятой
|
|
*
|
|
* @param float|null $kopeks Копейки
|
|
* @return float Рубли
|
|
*/
|
|
public static function toRub(?float $kopeks): float
|
|
{
|
|
return round(abs((float)$kopeks) / 100, 2);
|
|
}
|
|
|
|
/**
|
|
* Конвертирует рубли в копейки, учитывая только 2 знака после запятой
|
|
*
|
|
* @param float|null $rubles Рубли
|
|
* @return int Копейки
|
|
*/
|
|
public static function toKop(?float $rubles): int
|
|
{
|
|
return (int)round(abs((float)$rubles) * 100, 2);
|
|
}
|
|
|
|
/**
|
|
* Генерирует случайную строку указанной длины
|
|
*
|
|
* @param int $length Длина, по умолчанию 8
|
|
* @param bool $with_digits Включать ли цифры
|
|
* @return string
|
|
*/
|
|
public static function randomStr(int $length = 8, bool $with_digits = true): string
|
|
{
|
|
$alphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ' . ($with_digits ? '0123456789' : '');
|
|
$result = '';
|
|
for ($i = 0; $i < abs($length); $i++) {
|
|
$result .= $alphabet[mt_rand(0, strlen($alphabet) - 1)];
|
|
}
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Проверяет идентичность двух классов
|
|
*
|
|
* @param object|string $class1
|
|
* @param object|string $class2
|
|
* @return bool
|
|
*/
|
|
public static function isSameClass(object|string $class1, object|string $class2): bool
|
|
{
|
|
return (is_object($class1) ? $class1::class : $class1) === (is_object($class2) ? $class2::class : $class2);
|
|
}
|
|
|
|
/**
|
|
* Тестирует наследование класса (объекта) от указанных классов
|
|
*
|
|
* @param object|string $class Объект или имя класса для проверки
|
|
* @param string[] $parents Имена классов-родителей
|
|
* @see https://www.php.net/manual/ru/function.class-parents.php
|
|
*/
|
|
public static function checkExtendsClasses(object|string $class, array $parents): bool
|
|
{
|
|
return self::checkClassesIntersection($parents, $class, 'class_parents');
|
|
}
|
|
|
|
/**
|
|
* Тестирует имплементацию классом (объектом) указанных интерфейсов
|
|
*
|
|
* @param object|string $actual Объект или имя класса для проверки
|
|
* @param string[] $interfaces Имена классов-интерфейсов
|
|
* @see https://www.php.net/manual/ru/function.class-implements.php
|
|
*/
|
|
public static function checkImplementsInterfaces(object|string $actual, array $interfaces): bool
|
|
{
|
|
return self::checkClassesIntersection($interfaces, $actual, 'class_implements');
|
|
}
|
|
|
|
/**
|
|
* Тестирует использование классом (объектом) указанных трейтов
|
|
*
|
|
* @param object|string $class
|
|
* @param string[] $traits
|
|
* @return bool
|
|
* @see https://www.php.net/manual/ru/function.class-uses.php
|
|
*/
|
|
public static function checkUsesTraits(array $traits, object|string $class): bool
|
|
{
|
|
return self::checkClassesIntersection($traits, $class, 'class_uses');
|
|
}
|
|
|
|
/**
|
|
* Проверяет пересечение классов указанной функцией SPL
|
|
*
|
|
* @param object|string $class Класс для проверки на вхождение, или объект, класс коего нужно проверить
|
|
* @param string[] $classes Массив классов, вхождение в который нужно проверить
|
|
* @param string $function class_parents|class_implements|class_uses
|
|
*/
|
|
protected static function checkClassesIntersection(array $classes, object|string $class, string $function): bool
|
|
{
|
|
$actual_classes = is_object($class) ? $function($class) : [$class::class];
|
|
return is_array($actual_classes)
|
|
&& !empty(array_intersect($classes, $actual_classes));
|
|
}
|
|
}
|