Nativní Enumy, výraz match a jak funguje PSR-4 v composer.json

Nativní Backed Enumy v moderním PHP

Dříve se pevné množiny stavů (např. obtížnost modulu nebo fáze životního cyklu) v PHP řešily pomocí tříd s konstantami:

// Zastaralý přístup:
class OldDifficulty {
    public const BEGINNER = 'beginner';
    public const ADVANCED = 'advanced';
}
function setDifficulty(string $difficulty) {} // Žádná typová kontrola! Můžete předat 'xyz'.

Od PHP 8.1 máme k dispozici nativní Enumy. Pokud enum reprezentuje skalární hodnotu (např. uloženou v databázi), použijeme Backed Enum:

enum ModuleDifficulty: string
{
    case Beginner = 'beginner';
    case Intermediate = 'intermediate';
    case Advanced = 'advanced';
}

Výhody:

• Typová bezpečnost: Funkce vyžadující ModuleDifficulty odmítne jakýkoliv neplatný řetězec.
• Vlastní metody: Enum v PHP není jen tupý seznam hodnot – může obsahovat metody, rozhraní a bohaté chování.
• Přístup k hodnotě: Hodnotu získáte přes $enum->value, název konstanty přes $enum->name.

Výraz match: Moderní, striktní náhrada za switch

Tradiční konstrukce switch v PHP trpí několika závažnými problémy:

• Používá slabé porovnávání (==), což způsobuje bizarní chyby při porovnávání řetězců a čísel.
• Vyžaduje klíčové slovo break, jinak propadává do dalších větví (fall-through).
• Nevrací hodnotu přímo jako výraz.

V PHP 8.0 přišel výraz match:

public function label(): string
{
    return match ($this) {
        self::Beginner => 'Začátečník',
        self::Intermediate => 'Pokročilý',
        self::Advanced => 'Architekt / Produkce',
    };
}

Klíčové vlastnosti výrazu match:

1. Striktní porovnání: Vždy používá operátor identity ===.
2. Návratová hodnota: Je to plnohodnotný výraz (expression), jehož výsledek můžete přímo vrátit (return match) nebo přiřadit do proměnné.
3. Exhaustiveness check: Pokud některý stav enumu nepokryjete a neuvedete větev default, PHP vyhodí výjimku UnhandledMatchError. To je obrovská výhoda – pokud do enumu přidáte novou hodnotu, PHP engine i statická analýza (Larastan) vás okamžitě upozorní na všechna místa, kde chybí její obsluha.

Jak funguje PSR-4 Autoloading v composer.json

Aby PHP engine věděl, kde na disku najít třídu App\Enums\ModuleDifficulty, využívá standard PSR-4 definovaný v souboru composer.json:

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Database\\Factories\\": "database/factories/",
        "Database\\Seeders\\": "database/seeders/"
    }
}

Pravidlo funguje následovně:

1. Prefix jmenného prostoru App\ odpovídá kořenové složce app/.
2. Každé další zanoření v namespace odpovídá podadresáři se stejným názvem.
3. Třída App\Enums\ModuleDifficulty se proto musí nacházet v souboru app/Enums/ModuleDifficulty.php.

Při instalaci nebo po spuštění příkazu composer dump-autoload vygeneruje Composer optimalizovanou mapu do složky vendor/composer/autoload_psr4.php. Když kód poprvé použije třídu, registrovaný Composer autoloader bleskově vyhledá a načte příslušný soubor.