Конструктор PHP: __construct и продвижение свойств

Конструктор PHP это метод с именем __construct(). PHP вызывает его автоматически, когда вы пишете new ClassName(...), а аргументы в скобках становятся его параметрами, поэтому объект начинает жизнь с уже заданными значениями.

<?php
class User
{
    public string $name;
    public int $age;

    public function __construct(string $name, int $age)
    {
        $this->name = $name;
        $this->age = $age;
    }
}

$ada = new User('Ada', 36);
echo "{$ada->name} is {$ada->age}\n";

Без конструктора вы создавали бы пустой объект и задавали каждое свойство потом, и ничто не помешало бы забыть одно из них. С конструктором new User() без аргументов вызывает ArgumentCountError.

Продвижение свойств в конструкторе

Объявить свойство, указать его параметром и присвоить $this->name = $name значит повторить каждое имя трижды. Начиная с PHP 8.0 ключевое слово видимости перед параметром конструктора делает всё это разом:

<?php
class User
{
    public function __construct(
        public string $name,
        public int $age,
        private string $email = '',
    ) {}

    public function contact(): string
    {
        return $this->email !== '' ? $this->email : 'no email';
    }
}

$u = new User('Grace', 45, 'grace@example.com');
echo $u->name, ', ', $u->age, ', ', $u->contact(), "\n";

$v = new User('Linus', 28);
echo $v->name, ', ', $v->contact(), "\n";

Продвинутый параметр может быть и readonly (public readonly string $id), это самый короткий способ записать неизменяемый объект-значение. Продвинутые и обычные параметры можно смешивать, а в теле конструктора по-прежнему может быть код, который выполняется после присваивания продвинутых свойств.

Значения по умолчанию и именованные аргументы

Параметры конструктора принимают значения по умолчанию, как у любой функции. Параметры со значениями по умолчанию идут после обязательных. С именованными аргументами (PHP 8.0) вызывающий код может сразу указать нужную опцию, не повторяя все значения по умолчанию перед ней:

<?php
class Button
{
    public function __construct(
        public string $label,
        public string $color = 'blue',
        public string $size = 'medium',
        public bool $disabled = false,
    ) {}

    public function render(): string
    {
        $attr = $this->disabled ? ' disabled' : '';
        return "<button class=\"{$this->color} {$this->size}\"{$attr}>{$this->label}</button>";
    }
}

echo (new Button('Save'))->render(), "\n";
echo (new Button('Delete', 'red'))->render(), "\n";
echo (new Button('Wait', disabled: true))->render(), "\n";

Запустите: в выводе есть HTML, поэтому вкладка Page показывает три отрисованные кнопки, а вкладка Output теги, которые напечатал PHP. Обратите внимание на скобки в (new Button('Save'))->render(): начиная с PHP 8.4 они необязательны, но PHP 8.3 они нужны.

Проверка аргументов в конструкторе

Конструктор не может вернуть false или код ошибки: всё, что он возвращает, игнорируется. Чтобы отклонить неверные данные, выбросьте исключение. Тогда объект вообще не создаётся, и остальная программа может доверять каждому полученному Temperature.

<?php
class Temperature
{
    public function __construct(public readonly float $celsius)
    {
        if ($celsius < -273.15) {
            throw new InvalidArgumentException("Below absolute zero: $celsius");
        }
    }

    public function fahrenheit(): float
    {
        return $this->celsius * 9 / 5 + 32;
    }
}

echo (new Temperature(21.5))->fahrenheit(), "\n";

try {
    $t = new Temperature(-300);
} catch (InvalidArgumentException $e) {
    echo 'Rejected: ', $e->getMessage(), "\n";
}

Перехват таких исключений подробнее описан на странице try catch.

Несколько конструкторов через статические фабричные методы

В PHP нет перегрузки конструкторов: один класс, один __construct. Когда объект можно собрать из разных входных данных (строка даты, массив, временная метка), добавьте именованные статические методы, которые готовят аргументы и вызывают new static(...). Если сделать конструктор private, всем придётся идти через фабрики.

<?php
class Color
{
    private function __construct(
        public readonly int $r,
        public readonly int $g,
        public readonly int $b,
    ) {}

    public static function fromRgb(int $r, int $g, int $b): static
    {
        return new static($r, $g, $b);
    }

    public static function fromHex(string $hex): static
    {
        [$r, $g, $b] = sscanf(ltrim($hex, '#'), '%02x%02x%02x');
        return new static($r, $g, $b);
    }

    public function css(): string
    {
        return "rgb({$this->r}, {$this->g}, {$this->b})";
    }
}

echo Color::fromRgb(255, 128, 0)->css(), "\n";
echo Color::fromHex('#1e90ff')->css(), "\n";

new Color(1, 2, 3) снаружи класса теперь выбрасывает Error ("Call to private Color::__construct() from global scope"). Почему здесь используется new static, а не new self, объясняет страница о static.

Вызов конструктора родителя через parent::__construct

Когда дочерний класс определяет свой конструктор, конструктор родителя сам не выполняется. Вызовите его через parent::__construct(...), обычно первым, чтобы свойства родителя были заданы до того, как дочерний класс добавит свои:

<?php
class Vehicle
{
    public function __construct(
        protected string $brand,
        protected int $wheels = 4,
    ) {}

    public function describe(): string
    {
        return "{$this->brand} with {$this->wheels} wheels";
    }
}

class Truck extends Vehicle
{
    public function __construct(string $brand, private int $capacityKg)
    {
        parent::__construct($brand, 6);
    }

    public function describe(): string
    {
        return parent::describe() . ", carries {$this->capacityKg} kg";
    }
}

echo (new Vehicle('Fiat'))->describe(), "\n";
echo (new Truck('Volvo', 18000))->describe(), "\n";

Если у дочернего класса конструктора нет вовсе, PHP использует родительский, и new Truck('Volvo') передал бы аргументы прямо в Vehicle::__construct. Подробнее об этом в разделе о наследовании.

Забытый parent::__construct

Эта ошибка не даёт сообщения в той строке, где возникает. Конструктор дочернего класса выполняется, типизированные свойства родителя остаются неинициализированными, а программа падает позже, там, где их впервые читают:

<?php
class Model
{
    protected array $attributes;

    public function __construct()
    {
        $this->attributes = ['created' => '2026-03-14'];
    }

    public function get(string $key): mixed
    {
        return array_key_exists($key, $this->attributes) ? $this->attributes[$key] : null;
    }
}

class Post extends Model
{
    public function __construct(public string $title)
    {
        // parent::__construct() is missing
    }
}

$post = new Post('Hello');
try {
    echo $post->get('created'), "\n";
} catch (Error $e) {
    echo $e->getMessage(), "\n";
}

Добавьте parent::__construct(); первой строкой в Post::__construct и запустите снова: код выведет дату. Связанный метод __destruct() выполняется, когда исчезает последняя ссылка на объект или завершается скрипт. В повседневном коде он нужен редко, потому что PHP сам закрывает файлы и освобождает память в конце каждого запроса.