Readonly třídy, DTO objekty a Constructor Property Promotion

Revoluce v psaní tříd: Constructor Property Promotion

Před verzí PHP 8.0 vyžadovala definice jednoduchého datového objektu (DTO) značné množství duplicitního boilerplate kódu:

// Zastaralý přístup v PHP 7:
class OldUserDto {
    private string $name;
    private string $email;

    public function __construct(string $name, string $email) {
        $this->name = $name;
        $this->email = $email;
    }
    public function getName(): string { return $this->name; }
    public function getEmail(): string { return $this->email; }
}

V PHP 8.0 přišla zásadní inovace: Constructor Property Promotion. Pokud před parametr v konstruktoru přidáte modifikátor viditelnosti (public, protected nebo private), PHP engine automaticky:

1. Deklaruje vlastnost třídy se stejným jménem a typem.
2. Při vytvoření instance přiřadí předaný argument přímo do této vlastnosti.

Konstruktor se tak zredukuje na pouhou signaturu bez jediného řádku v těle!

Neměnnost s readonly class

V PHP 8.1 byly představeny readonly vlastnosti – vlastnost lze nastavit pouze jednou (typicky v konstruktoru) a jakýkoliv další pokus o zápis vyvolá Error.

PHP 8.2 posunulo koncept ještě dál představením readonly class:

final readonly class AnatomyFileNodeData
{
    public function __construct(
        public string $path,
        public string $category,
        public string $description,
        public bool $exists,
        public int $lineCount,
        public int $sizeBytes,
        public string $content,
    ) {}
}

Když označíte celou třídu klíčovým slovem readonly:

• Všechny vlastnosti třídy se automaticky stanou readonly (nemusíte psát readonly před každou proměnnou).
• Třídě nelze dynamicky přidávat vlastnosti za běhu ($node->foo = 'bar' způsobí chybu).
• Zaručuje absolutní immutabilitu (neměnnost) stavu objektu po jeho inicializaci.

Proč je immutabilita kritická ve FrankenPHP a moderních runtimech?

V klasickém PHP-FPM modelu proces po dokončení každého HTTP požadavku zemře a veškerá paměť je uvolněna.

V moderních aplikačních serverech jako je FrankenPHP (nebo RoadRunner) však PHP běží v tzv. Worker módu. Aplikační proces žije nepřetržitě v paměti a postupně odbavuje tisíce HTTP požadavků za sebou:

1. Pokud by vaše služby nebo DTO objekty měly modifikovatelný vnitřní stav (mutable state), mohlo by dojít k prosáknutí dat mezi dvěma různými uživateli!
2. Neměnné DTO objekty (readonly) garantují, že jakmile data jednou vytvoříte, žádná jiná část aplikace je nemůže nepozorovaně přepsat.
3. Kód je plně bezpečný, predikovatelný a vláknově stabilní.

V naší aplikaci agy-laravel používáme final readonly class pro všechny datové přenosy mezi službou AnatomyInspectorService, Livewire komponentami a Blade šablonami.