Что представляет собой механизм promotion-свойств в конструкторах PHP 8, какие преимущества и ограничения он даёт?

Question

Promotion-свойства в PHP 8 позволяют объявлять и инициализировать свойства класса прямо в списке аргументов конструктора, без дублирования кода. Вместо того чтобы отдельно объявлять свойства и присваивать им значения в теле конструктора, достаточно указать модификатор видимости в параметре. Это уменьшает "шум" в коде и делает класс компактнее и нагляднее. Однако так можно объявлять только нестатические свойства, и такой синтаксис иногда хуже подходит для сложной логики инициализации. Также он не работает с параметрами без модификаторов видимости или с теми, где нужно сложное присваивание.

YeaHub · Accepted Answer

Механизм promotion-свойств в PHP 8Promotion-свойства (constructor property promotion) — это синтаксический сахар, упрощающий объявление и инициализацию свойств в классах.Определение: Constructor property promotion — это возможность объявить и проинициализировать свойство класса прямо в сигнатуре конструктора через указание модификатора видимости у параметра.1. Как было до PHP 8До PHP 8 типичный класс с несколькими полями выглядел так:phpclass User {
    private string $name;
    private string $email;
    private int $age;

public function __construct(string $name, string $email, int $age)
    {
        $this->name  = $name;
        $this->email = $email;
        $this->age   = $age;
    }
}
Здесь возникает дублирование:переменные объявляются как свойствате же имена повторяются в параметрах конструкторазатем ещё раз повторяются при присваивании this->... = ...2. Как работает promotion в PHP 8В PHP 8 можно записать тот же класс более компактно:phpclass User {
    public function __construct(
        private string $name,
        private string $email,
        private int $age,
    ) {}
}
Что происходит "под капотом":Для каждого параметра с модификатором видимости (public, protected, private) автоматически создаётся свойство класса.Это свойство получает:указанный модификатор видимостиуказанный типимя, совпадающее с именем параметраВ конструкторе автоматически выполняется присваивание этого параметра в свойство.Фактически PHP сам за вас генерирует обычные объявления свойств и присваивания.3. Ограничения и правила использованияВажно понимать, что promotion-свойства не "волшебство", а более короткий синтаксис с рядом ограничений:Только в конструктореPromotion работает только в методе __construct. Нельзя использовать этот синтаксис в других методах.Обязателен модификатор видимостиЕсли в параметре нет public/protected/private, это обычный аргумент, а не свойство:phpclass User {
    public function __construct(
        private string $name,
        string $rawPassword // это просто аргумент, не свойство
    ) {}
}
Нельзя использовать для статических свойствСтатические свойства не поддерживаются для promotion.public static в списке параметров конструктора использовать нельзя.Нельзя смешивать с var и другими нестандартными модификаторамиPromotion работает только с public, protected, private, при необходимости с readonly (в новых версиях).Нельзя использовать сложные выражения в объявленииВы можете задать значение по умолчанию, но не сложную логику. Сложная логика должна быть в теле конструктора.4. Преимущества механизма promotion-свойствКогда стоит применять promotion:Меньше шаблонного кода (boilerplate)Не нужно объявлять свойства отдельно.Не нужно прописывать this->... = ... для каждого параметра.Лучшая читабельность при простых моделяхВся структура объекта видна в одном месте — в сигнатуре конструктора. Это удобно для DTO, value-объектов и простых доменных сущностей.Меньше риска ошибок при копированииМеньше повторений — меньше шансов забыть инициализировать какое-то свойство.Хорошо комбинируется с readonlyДля неизменяемых объектов (например, value object) синтаксис становится очень выразительным:phpclass Point {
    public function __construct(
        public readonly float $x,
        public readonly float $y,
    ) {}
}
5. Недостатки и когда лучше не использоватьЕсть ситуации, в которых promotion-свойства усложняют понимание или становятся неудобными:Сложная инициализацияЕсли при создании объекта вам нужно выполнять валидацию, преобразование или дополнительную логику, лучше явно описать свойства и тело конструктора:phpclass User {
    private string $email;

public function __construct(string $email)
    {
        // валидация e-mail
        if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
            throw new InvalidArgumentException('Invalid email');
        }

$this->email = strtolower($email);
    }
}
Формально можно использовать promotion и отдельные свойства/логику, но код станет менее прозрачным.Модели с множеством необязательных полейПри большом количестве параметров конструктор с promotion может стать длинным и тяжело читаемым. Иногда проще использовать обычные свойства и сеттеры/билдер.Переопределение конструктора в наследованииВ сложной иерархии классов, где конструкторы активно переопределяются, использование promotion в базовых и наследниках иногда запутывает читающего код.6. ВыводPromotion-свойства — это удобный синтаксический сахар для простых, "плоских" объектов с прямой инициализацией полей. Их стоит активно использовать для DTO, value-объектов и простых сущностей, но быть аккуратным в местах со сложной логикой конструирования и наследованием.