Работа с конструкторами классов в PHP

Пример 1: Статический фабричный метод вместо множественных конструкторов

PHP не поддерживает перегрузку конструкторов. Для создания объектов с разным набором параметров используются именованные конструкторы (статические методы).

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

    public static function fromArray(array $data): self {
        return new self($data['name'], (int)$data['age']);
    }

    public static function fromJson(string $json): self {
        $data = json_decode($json, true);
        return self::fromArray($data);
    }
}

$user1 = User::fromArray(['name' => 'Иван', 'age' => 25]);
$user2 = User::fromJson('{"name":"Мария","age":30}');
var_dump($user1, $user2);
?>

object(User)#1 (2) {
  ["name"] => string(8) "Иван"
  ["age"] => int(25)
}
object(User)#2 (2) {
  ["name"] => string(10) "Мария"
  ["age"] => int(30)
}

Такой подход часто используется в ActiveRecord или DTO. Ошибка: приватный конструктор защищает от прямого создания, но может усложнить тестирование.

Пример 2: Вариативные параметры и распаковка массива

Оператор ... (spread) позволяет передавать переменное количество аргументов или распаковывать массив в параметры конструктора.

<?php
class Group {
    /** @var string[] */
    public array $members;

    public function __construct(string ...$members) {
        $this->members = $members;
    }
}

$group = new Group('Анна', 'Борис', 'Виктор');

$names = ['Дмитрий', 'Елена'];
$group2 = new Group(...$names);

var_dump($group, $group2);
?>

object(Group)#1 (1) {
  ["members"] => array(3) {
    [0] => string(8) "Анна"
    [1] => string(10) "Борис"
    [2] => string(12) "Виктор"
  }
}
object(Group)#2 (1) {
  ["members"] => array(2) {
    [0] => string(14) "Дмитрий"
    [1] => string(10) "Елена"
  }
}

Типичная ошибка: передача массива без оператора ... приводит к одному аргументу-массиву, а не к нескольким строкам.

Пример 3: Конструктор с трейтами и разрешение конфликтов

Если два трейта объявляют метод __construct, возникает конфликт. Его разрешают через insteadof и as.

<?php
trait Initializable {
    public function __construct() {
        echo "Trait init\n";
    }
}

trait Setup {
    public function __construct() {
        echo "Setup init\n";
    }
}

class App {
    use Initializable, Setup {
        Initializable::__construct insteadof Setup;
        Setup::__construct as private setupInit;
    }

    public function __construct() {
        $this->setupInit();
        echo "App construct\n";
    }
}

$app = new App();
?>

Setup init
App construct

Здесь выбран конструктор из трейта Initializable, но метод из Setup переименован и вызван вручную. Ошибка: если не разрешить конфликт, PHP выдаст фатальную ошибку.

Пример 4: Конструктор с вычисляемыми значениями по умолчанию

Значение по умолчанию может быть константой, вызовом функции или выражением, но не переменной из другого контекста.

<?php
class Timestamp {
    public function __construct(
        public readonly int $createdAt = time(),
        public readonly string $timezone = date_default_timezone_get()
    ) {}
}

$t1 = new Timestamp();
$t2 = new Timestamp(1234567890); // конкретная метка
?>

Ошибка: нельзя использовать в качестве значения по умолчанию другой параметр или $this. Решение: присваивать в теле конструктора.