PHP конструктор: полное описание и примеры

Конструктор с только для чтения свойствами (readonly, PHP 8.1)

Свойства, объявленные как readonly, могут быть установлены только один раз, обычно в конструкторе.

class ImmutablePoint {
    public function __construct(
        public readonly int $x,
        public readonly int $y
    ) {}
}

$point = new ImmutablePoint(10, 20);
// $point->x = 30; // Ошибка: cannot modify readonly property

Fatal error: Uncaught Error: Cannot modify readonly property ImmutablePoint::$x

Цель: создание неизменяемых объектов (Value Objects). Проблема: readonly свойства нельзя использовать с типами, допускающими null, если они не инициализированы.

Конструктор в трейте

Трейты могут содержать конструктор, который будет вызван, если класс не определяет свой собственный.

trait Timestampable {
    public DateTime $createdAt;

    public function __construct() {
        $this->createdAt = new DateTime();
    }
}

class Article {
    use Timestampable;

    public string $title;

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

$article = new Article('Новости');
echo $article->createdAt->format('Y-m-d');

2025-01-29 (текущая дата)

Важно: если класс переопределяет конструктор, трейт-конструктор не вызывается автоматически. Для вызова трейтового конструктора нужно явно использовать parent::__construct() (но трейт не является родителем). Вместо этого рекомендуется использовать паттерн с фабриками или инициализацией через отдельный метод.

Фабричный статический метод вместо множественных конструкторов

PHP не поддерживает несколько конструкторов с разными сигнатурами. Альтернатива - приватный конструктор и статические фабричные методы.

class User {
    private string $name;

    private function __construct(string $name) {
        $this->name = $name;
    }

    public static function fromEmail(string $email): self {
        $name = explode('@', $email)[0];
        return new self($name);
    }

    public static function fromId(int $id): self {
        // загрузка из БД
        $name = "User_$id";
        return new self($name);
    }
}

$user1 = User::fromEmail('ivan@example.com');
$user2 = User::fromId(42);

Цель: создать объект разными способами без путаницы в параметрах. Проблема: приватный конструктор скрыт, все создание идет через фабрики.

Валидация в конструкторе и выброс исключений

Конструктор может проверять входные данные и выбрасывать исключения при неверных значениях.

class EmailAddress {
    private string $email;

    public function __construct(string $email) {
        if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
            throw new InvalidArgumentException("Некорректный email: $email");
        }
        $this->email = $email;
    }
}

try {
    $email = new EmailAddress('invalid');
} catch (InvalidArgumentException $e) {
    echo $e->getMessage();
}

Некорректный email: invalid

Цель: гарантировать, что объект всегда находится в валидном состоянии. Проблема: при наследовании валидация может усложниться.

Использование match в конструкторе для стратегий

Можно выбирать реализацию в зависимости от переданного параметра.

interface Handler {
    public function handle(): void;
}

class AHandler implements Handler {
    public function handle(): void { echo "Обработчик A"; }
}

class BHandler implements Handler {
    public function handle(): void { echo "Обработчик B"; }
}

class App {
    private Handler $handler;

    public function __construct(string $type) {
        $this->handler = match($type) {
            'a' => new AHandler(),
            'b' => new BHandler(),
            default => throw new InvalidArgumentException("Неизвестный тип: $type")
        };
    }

    public function run(): void {
        $this->handler->handle();
    }
}

$app = new App('a');
$app->run();

Обработчик A

Цель: отделение логики выбора от клиентского кода. Проблема: конструктор становится ответственным за создание зависимостей, что затрудняет тестирование.

Конструктор с внедрением зависимостей (DI)

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

class Logger {
    public function log(string $msg): void {
        echo "[LOG] $msg";
    }
}

class UserService {
    private Logger $logger;

    public function __construct(Logger $logger) {
        $this->logger = $logger;
    }

    public function createUser(string $name): void {
        // создание пользователя
        $this->logger->log("Создан пользователь $name");
    }
}

$logger = new Logger();
$service = new UserService($logger);
$service->createUser('Анна');

[LOG] Создан пользователь Анна

Цель: слабая связанность и простое тестирование (можно подменить Logger на mock). Проблема: при большом количестве зависимостей конструктор становится громоздким.