Helper class в PHP: эффективные приёмы для организации утилит

Расширенные примеры вспомогательных классов

Класс-хелпер для валидации данных

class ValidatorHelper {
    public static function isEmail(string $email): bool {
        return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
    }
    
    public static function isPhone(string $phone, string $country = 'RU'): bool {
        $pattern = ($country === 'RU') ? '/^7[0-9]{10}$/' : '/^[0-9]{7,15}$/';
        return preg_match($pattern, preg_replace('/[\s\-()]/', '', $phone)) === 1;
    }
    
    public static function isUrl(string $url): bool {
        return filter_var($url, FILTER_VALIDATE_URL) !== false;
    }
    
    public static function passwordStrength(string $password): int {
        $score = 0;
        if (strlen($password) >= 8) $score++;
        if (preg_match('/[A-Z]/', $password)) $score++;
        if (preg_match('/[a-z]/', $password)) $score++;
        if (preg_match('/[0-9]/', $password)) $score++;
        if (preg_match('/[^a-zA-Z0-9]/', $password)) $score++;
        return $score;
    }
}

// Пример использования и вывод
echo 'Email test: ' . (ValidatorHelper::isEmail('user@example.com') ? 'ok' : 'fail') . "\n";
echo 'Phone test: ' . (ValidatorHelper::isPhone('+7 912 345-67-89') ? 'ok' : 'fail') . "\n";
echo 'Password strength: ' . ValidatorHelper::passwordStrength('Pass123#!');

Email test: ok
Phone test: ok
Password strength: 5

Хелпер для работы с массивами

class ArrayHelper {
    public static function sortByKey(array &$array, string $key, int $order = SORT_ASC): void {
        usort($array, function($a, $b) use ($key, $order) {
            $cmp = strcmp($a[$key] ?? '', $b[$key] ?? '');
            return ($order === SORT_ASC) ? $cmp : -$cmp;
        });
    }
    
    public static function groupBy(array $array, callable $callback): array {
        $result = [];
        foreach ($array as $item) {
            $groupKey = $callback($item);
            $result[$groupKey][] = $item;
        }
        return $result;
    }
    
    public static function flatten(array $array, int $depth = INF): array {
        $result = [];
        array_walk_recursive($array, function($value) use (&$result) {
            $result[] = $value;
        });
        return $result;
    }
}

$users = [['name' => 'Anna', 'age' => 30], ['name' => 'Boris', 'age' => 25], ['name' => 'Anna', 'age' => 28]];
ArrayHelper::sortByKey($users, 'age', SORT_DESC);
print_r($users);
$grouped = ArrayHelper::groupBy($users, function($u) { return $u['name']; });
print_r($grouped);

Array
(
    [0] => Array ( [name] => Anna [age] => 30 )
    [1] => Array ( [name] => Anna [age] => 28 )
    [2] => Array ( [name] => Boris [age] => 25 )
)
Array
(
    [Anna] => Array (
        [0] => Array ( [name] => Anna [age] => 30 )
        [1] => Array ( [name] => Anna [age] => 28 )
    )
    [Boris] => Array (
        [0] => Array ( [name] => Boris [age] => 25 )
    )
)

Хелпер для форматирования чисел и дат

class FormatHelper {
    public static function money(float $amount, string $currency = 'RUB', string $locale = 'ru_RU'): string {
        $formatter = new \NumberFormatter($locale, \NumberFormatter::CURRENCY);
        return $formatter->formatCurrency($amount, $currency);
    }
    
    public static function filesize(int $bytes, int $precision = 2): string {
        $units = ['B', 'KB', 'MB', 'GB', 'TB'];
        $i = 0;
        while ($bytes >= 1024 && $i < count($units) - 1) {
            $bytes /= 1024;
            $i++;
        }
        return round($bytes, $precision) . ' ' . $units[$i];
    }
    
    public static function dateDiffForHumans(\DateTimeInterface $date, \DateTimeInterface $now = null): string {
        $now = $now ?? new \DateTimeImmutable();
        $interval = $now->diff($date);
        if ($interval->y > 0) return $interval->y . ' год(а) назад';
        if ($interval->m > 0) return $interval->m . ' месяц(ев) назад';
        if ($interval->d > 0) return $interval->d . ' дн(я) назад';
        if ($interval->h > 0) return $interval->h . ' час(ов) назад';
        if ($interval->i > 0) return $interval->i . ' минут(ы) назад';
        return 'только что';
    }
}

echo FormatHelper::money(1234.56) . "\n";
echo FormatHelper::filesize(1234567) . "\n";
echo FormatHelper::dateDiffForHumans(new \DateTime('-2 days'));

1 234,56 ₽
1.18 MB
2 дн(я) назад

Комбинирование трейтов с классами-хелперами

trait JsonHelper {
    public function toJson($data, int $options = 0): string {
        return json_encode($data, $options | JSON_UNESCAPED_UNICODE);
    }
    
    public function fromJson(string $json, bool $assoc = true): mixed {
        return json_decode($json, $assoc, 512, JSON_THROW_ON_ERROR);
    }
}

class ApiResponse {
    use JsonHelper;
    
    public function success(array $data): string {
        return $this->toJson(['status' => 'ok', 'data' => $data]);
    }
    
    public function error(string $message): string {
        return $this->toJson(['status' => 'error', 'message' => $message]);
    }
}

$response = new ApiResponse();
echo $response->success(['user' => 'Anna']);

{"status":"ok","data":{"user":"Anna"}}

Хелпер с кешированием (использование локального состояния)

class CacheHelper {
    private static array $cache = [];
    
    public static function remember(string $key, callable $callback, int $ttl = 60): mixed {
        if (isset(self::$cache[$key]) && (time() - self::$cache[$key]['time']) < $ttl) {
            return self::$cache[$key]['value'];
        }
        $value = $callback();
        self::$cache[$key] = ['value' => $value, 'time' => time()];
        return $value;
    }
    
    public static function forget(string $key): void {
        unset(self::$cache[$key]);
    }
}

$result = CacheHelper::remember('expensive_calc', function() {
    sleep(2); // имитация тяжёлого вычисления
    return 42;
});
echo $result; // 42 (первый вызов – ожидание 2 сек)
$result = CacheHelper::remember('expensive_calc', function() {
    return 100; // не выполнится
});
echo $result; // 42 (из кеша)

42
42

Хелпер для HTTP-запросов (обёртка над cURL)

class HttpClient {
    public static function get(string $url, array $headers = []): string {
        $ch = curl_init();
        curl_setopt_array($ch, [
            CURLOPT_URL => $url,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => $headers,
            CURLOPT_TIMEOUT => 10,
        ]);
        $response = curl_exec($ch);
        if (curl_errno($ch)) {
            throw new \RuntimeException('cURL error: ' . curl_error($ch));
        }
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        if ($httpCode >= 400) {
            throw new \RuntimeException("HTTP error $httpCode");
        }
        return $response;
    }
    
    public static function post(string $url, array $data, array $headers = []): string {
        $ch = curl_init();
        curl_setopt_array($ch, [
            CURLOPT_URL => $url,
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => http_build_query($data),
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => $headers,
        ]);
        $response = curl_exec($ch);
        if (curl_errno($ch)) {
            throw new \RuntimeException('cURL error: ' . curl_error($ch));
        }
        curl_close($ch);
        return $response;
    }
}

// Пример (требуется рабочий endpoint)
// echo HttpClient::get('https://api.example.com/status');

(вывод зависит от реального ответа)