Линтовка

This commit is contained in:
2026-01-03 01:12:18 +08:00
parent ddc4374dd6
commit aabad9d744
20 changed files with 224 additions and 190 deletions

View File

@@ -1,4 +1,5 @@
<?php
/*
* Copyright (c) 2025, Антон Аксенов
* This file is part of m3u.su project
@@ -17,8 +18,8 @@ if (!function_exists('root_path')) {
/**
* Возвращает абсолютный путь к корневой директории приложения.
*
* @param string $path Относительный путь для добавления к корневому.
* @return string Абсолютный путь.
* @param string $path относительный путь для добавления к корневому
* @return string абсолютный путь
*/
function root_path(string $path = ''): string
{
@@ -32,12 +33,12 @@ if (!function_exists('config_path')) {
/**
* Возвращает абсолютный путь к директории конфигурации приложения.
*
* @param string $path Относительный путь для добавления к директории конфигурации.
* @return string Абсолютный путь.
* @param string $path относительный путь для добавления к директории конфигурации
* @return string абсолютный путь
*/
function config_path(string $path = ''): string
{
return root_path("config/$path");
return root_path("config/{$path}");
}
}
@@ -45,12 +46,12 @@ if (!function_exists('cache_path')) {
/**
* Возвращает абсолютный путь к директории кэша приложения.
*
* @param string $path Относительный путь для добавления к директории кэша.
* @return string Абсолютный путь.
* @param string $path относительный путь для добавления к директории кэша
* @return string абсолютный путь
*/
function cache_path(string $path = ''): string
{
return root_path("cache/$path");
return root_path("cache/{$path}");
}
}
@@ -58,8 +59,8 @@ if (!function_exists('base_url')) {
/**
* Возвращает базовый URL приложения.
*
* @param string $route Дополнительный маршрут, который будет добавлен к базовому URL.
* @return string Полный URL.
* @param string $route дополнительный маршрут, который будет добавлен к базовому URL
* @return string полный URL
*/
function base_url(string $route = ''): string
{
@@ -71,7 +72,7 @@ if (!function_exists('kernel')) {
/**
* Возвращает синглтон-экземпляр ядра приложения.
*
* @return Kernel Экземпляр ядра приложения.
* @return Kernel экземпляр ядра приложения
*/
function kernel(): Kernel
{
@@ -83,7 +84,7 @@ if (!function_exists('app')) {
/**
* Возвращает синглтон-экземпляр Slim-приложения.
*
* @return App Экземпляр Slim-приложения.
* @return App экземпляр Slim-приложения
*/
function app(): App
{
@@ -95,9 +96,9 @@ if (!function_exists('config')) {
/**
* Возвращает значение из конфигурации приложения.
*
* @param string $key Ключ конфигурации.
* @param mixed $default Значение по умолчанию, если ключ не найден.
* @return mixed Значение конфигурации или значение по умолчанию.
* @param string $key ключ конфигурации
* @param mixed $default значение по умолчанию, если ключ не найден
* @return mixed значение конфигурации или значение по умолчанию
*/
function config(string $key, mixed $default = null): mixed
{
@@ -109,7 +110,7 @@ if (!function_exists('redis')) {
/**
* Возвращает синглтон-экземпляр Redis-клиента.
*
* @return Redis Экземпляр Redis-клиента.
* @return Redis экземпляр Redis-клиента
*/
function redis(): Redis
{
@@ -121,7 +122,7 @@ if (!function_exists('ini')) {
/**
* Возвращает синглтон-экземпляр IniFile.
*
* @return IniFile Экземпляр IniFile.
* @return IniFile экземпляр IniFile
*/
function ini(): IniFile
{
@@ -273,11 +274,11 @@ if (!function_exists('env')) {
/**
* Возвращает значение переменной окружения.
*
* @param string $key Ключ переменной окружения.
* @param mixed $default Значение по умолчанию, если переменная не найдена.
* @param bool $required Бросать исключение, если переменная обязательна и не найдена.
* @return mixed Значение переменной окружения или значение по умолчанию.
* @throws InvalidArgumentException Если переменная обязательна и не найдена.
* @param string $key ключ переменной окружения
* @param mixed $default значение по умолчанию, если переменная не найдена
* @param bool $required бросать исключение, если переменная обязательна и не найдена
* @return mixed значение переменной окружения или значение по умолчанию
* @throws InvalidArgumentException если переменная обязательна и не найдена
*/
function env(string $key, mixed $default = null, bool $required = false): mixed
{
@@ -311,7 +312,7 @@ if (!function_exists('here')) {
* @param bool $asArray массив или строка в формате `<file|class>:<func>():<line>`
* @return string|array
*/
function here(bool $asArray = false): string|array
function here(bool $asArray = false): array|string
{
$trace = debug_backtrace(!DEBUG_BACKTRACE_PROVIDE_OBJECT | DEBUG_BACKTRACE_IGNORE_ARGS, 2);
@@ -386,7 +387,7 @@ if (!function_exists('as_data_url')) {
*/
function as_data_url(string $data, string $mimeType = 'text/plain'): string
{
return "data://$mimeType,$data";
return "data://{$mimeType},{$data}";
}
}
@@ -473,7 +474,7 @@ if (!function_exists('number_format_local')) {
* @return string Отформатированное число
*/
function number_format_local(
int|float $number,
float|int $number,
int $decimals = 0,
string $decPoint = '.',
string $thousandsSep = ' ',
@@ -494,7 +495,7 @@ if (!function_exists('format_bytes')) {
{
$units = ['Б', 'КБ', 'МБ', 'ГБ', 'ТБ'];
for ($i = 0; $bytes > 1024 && $i < count($units) - 1; $i++) {
for ($i = 0; $bytes > 1024 && $i < count($units) - 1; ++$i) {
$bytes /= 1024;
}
@@ -581,11 +582,12 @@ if (!function_exists('get_noun_form')) {
if ($lastDigit === 1) {
return $form1;
} elseif ($lastDigit >= 2 && $lastDigit <= 4) {
return $form2;
} else {
return $form5;
}
if ($lastDigit >= 2 && $lastDigit <= 4) {
return $form2;
}
return $form5;
}
}
@@ -605,7 +607,7 @@ if (!function_exists('random_string')) {
$result = '';
$max = strlen($chars) - 1;
for ($i = 0; $i < $length; $i++) {
for ($i = 0; $i < $length; ++$i) {
$result .= $chars[random_int(0, $max)];
}
@@ -702,7 +704,7 @@ if (!function_exists('recast')) {
function recast(string $className, stdClass &$object): mixed
{
if (!class_exists($className)) {
throw new InvalidArgumentException("Class not found: $className");
throw new InvalidArgumentException("Class not found: {$className}");
}
$new = new $className();
@@ -769,7 +771,7 @@ if (!function_exists('mb_count_chars')) {
for ($i = 0; $i < $length; ++$i) {
$char = mb_substr($string, $i, 1, 'UTF-8');
!array_key_exists($char, $unique) && $unique[$char] = 0;
$unique[$char]++;
++$unique[$char];
}
return $unique;
@@ -853,7 +855,7 @@ if (!function_exists('array_last')) {
return $array[$lastKey];
}
for ($i = count($keys) - 1; $i >= 0; $i--) {
for ($i = count($keys) - 1; $i >= 0; --$i) {
$key = $keys[$i];
if ($callback($array[$key], $key)) {
return $array[$key];
@@ -916,7 +918,7 @@ if (!function_exists('array_get')) {
* @param mixed $default Значение по умолчанию
* @return mixed Значение из массива или значение по умолчанию
*/
function array_get(array $array, string|int $key, mixed $default = null): mixed
function array_get(array $array, int|string $key, mixed $default = null): mixed
{
return $array[$key] ?? $default;
}
@@ -1118,7 +1120,7 @@ if (!function_exists('array_recursive_diff')) {
$aReturn[$key] = $aRecursiveDiff;
}
} else {
if ($value != $b[$key]) {
if ($value !== $b[$key]) {
$aReturn[$key] = $value;
}
}
@@ -1400,7 +1402,7 @@ if (!function_exists('flatten')) {
*
* @param array $tree Дерево (например, результат функции tree())
* @param string $branching Ключ ноды, под которым находится массив с дочерними нодами
* @param null|string $leafProperty Ключ ноды, значение коего определяет является ли каждая нода родителем
* @param string|null $leafProperty Ключ ноды, значение коего определяет является ли каждая нода родителем
* @return array Плоский список
*/
function flatten(
@@ -1459,8 +1461,8 @@ if (!function_exists('clear_tree')) {
*
* @param array $node Нода, которая должна быть обработана
* @param string $branching Ключ ноды, под которым находится массив с дочерними нодами
* @param null|string $leafProperty Ключ ноды, значение коего определяет является ли каждая нода родителем
* @return null|array Обработанная нода с хотя бы одним потомком либо null
* @param string|null $leafProperty Ключ ноды, значение коего определяет является ли каждая нода родителем
* @return array|null Обработанная нода с хотя бы одним потомком либо null
*/
function clear_tree(
array $node,