breadcrumb-the-shire/core/Http/AssetDetector.php

<?php

namespace MintyPHP\Http;

/**
 * Detects static asset requests that should bypass locale redirects.
 */
class AssetDetector
{
    /** File extensions that indicate static assets */
    private const ASSET_EXTENSIONS = [
        'css', 'js', 'mjs', 'map',
        'png', 'jpg', 'jpeg', 'gif', 'svg', 'ico', 'webp',
        'woff', 'woff2', 'ttf', 'eot',
        'webmanifest',
    ];

    /** Path prefixes that indicate static asset directories */
    private const ASSET_PREFIXES = [
        'vendor/',
        'css/',
        'js/',
        'favicon/',
        'brand/',
    ];

    /**
     * Check if the given path is a static asset request.
     */
    public static function isAssetRequest(string $path): bool
    {
        if ($path === '') {
            return false;
        }

        // Check file extension
        if (self::hasAssetExtension($path)) {
            return true;
        }

        // Check directory prefix
        foreach (self::ASSET_PREFIXES as $prefix) {
            if (str_starts_with($path, $prefix)) {
                return true;
            }
        }

        return false;
    }

    private static function hasAssetExtension(string $path): bool
    {
        $extension = strtolower(pathinfo($path, PATHINFO_EXTENSION));
        return $extension !== '' && in_array($extension, self::ASSET_EXTENSIONS, true);
    }
}