PHPTime

Getter’ы и setter’ы в PHP: магия, которая должна знать своё место

Магические методы __get и __set выглядят удобно, но в типичных сценариях приносят больше вреда, чем пользы. Разбираемся, как в современных версиях PHP организовать контроль доступа к свойствам без потери читабельности и подсказок IDE.

Зачем вообще контролировать доступ к свойствам

Начнём с простого класса:

PHP
<?php

declare(strict_types=1);

final class Animal
{
    public int $weightInKgs;
}

$cow = new Animal();
$cow->weightInKgs = -100; // Корова с отрицательной массой — это нормально?

Если свойство публичное, никто не помешает записать в него мусор. Отрицательный вес, количество ног равное семи, пустую строку вместо статуса — валидация отсутствует. Именно для таких ситуаций и нужны методы доступа. Но реализовывать их можно по-разному.

Магические __get и __set: заманчиво, но опасно

Магические методы перехватывают обращение к недоступным или несуществующим свойствам:

PHP
<?php

final class Animal
{
    private array $properties = [];

    public function __get(string $name): mixed
    {
        if (array_key_exists($name, $this->properties)) {
            return $this->properties[$name];
        }

        throw new RuntimeException(sprintf('Undefined property %s', $name));
    }

    public function __set(string $name, mixed $value): void
    {
        if ($name === 'weight') {
            if ($value < 100) {
                throw new InvalidArgumentException('The weight is too small!');
            }
        }

        $this->properties[$name] = $value;
    }
}

$cow = new Animal();
$cow->weightInKgs = -100; // InvalidArgumentException

На первый взгляд работает. Проблемы начинаются, когда свойств становится больше пяти.

Чем плох такой подход

  • Нет автодополнения. IDE не знает, какие «свойства» реально существуют у объекта. Опечатка $cow->wieght молча создаст новое поле вместо ошибки.
  • Один большой if-else. По мере роста класса __set превращается в god-метод, который знает всё про все свойства. Это усложняет изменение кода и тестирование.
  • Нет контроля типов. Даже со строгой типизацией mixed значение может быть чем угодно. Для отдельного сеттера можно объявить int или string.
  • Невозможность передать несколько параметров. Если нужно установить цену товара в конкретном магазине — $store->setPrice('item-1', 100) — __set не подойдёт: он принимает ровно один параметр значения.
  • Медленнее. Каждое обращение к свойству — это вызов магического метода. В горячих циклах это ощутимо.

Если нужны именно динамические наборы данных, для этого есть массивы и объекты stdClass. Не нужно весь класс превращать в «магический контейнер».

Явные геттеры и сеттеры: предсказуемая рутина

Когда бизнес-логика завязана на изменение свойства, явный метод доступа — самый понятный вариант:

PHP
<?php

declare(strict_types=1);

final class Animal
{
    private int $weightInKgs = 0;
    private int $numberOfLegs = 0;
    private int $numberOfHooves = 0;

    public function setNumberOfLegs(int $numberOfLegs): void
    {
        if ($numberOfLegs !== 4) {
            throw new InvalidArgumentException('The number of legs is too little or too big');
        }

        $this->numberOfLegs = $numberOfLegs;
        $this->numberOfHooves = $numberOfLegs; // Копыта всегда привязаны к ногам.
    }

    public function getNumberOfLegs(): int
    {
        return $this->numberOfLegs;
    }

    public function setWeight(int $weightInKgs): void
    {
        if ($weightInKgs < 100) {
            throw new InvalidArgumentException('The weight is too small!');
        }

        $this->weightInKgs = $weightInKgs;
    }

    public function getWeight(): int
    {
        return $this->weightInKgs;
    }
}

Каждый метод отвечает за свою зону ответственности. Логика распределена по классу, а не свалена в один гигантский if. IDE подсказывает имена методов, количество и типы аргументов. Опечатка setWieght() будет поймана на уровне синтаксического анализа.

Но есть нюанс: не для всех свойств нужны геттеры и сеттеры. Если свойство просто хранит данные и не требует валидации — оставьте его публичным. В примере с животным можно было бы сделать публичным nickname.

Что предлагает современный PHP

Начиная с PHP 8.1 в языке появились readonly-свойства. Они привносят важный сдвиг в проектировании классов. Раньше типичный DTO выглядел как простыня из геттеров. Теперь всё проще.

Readonly-свойства: инициализация один раз

PHP
<?php

declare(strict_types=1);

final readonly class AnimalDto
{
    public function __construct(
        public int $weightInKgs,
        public int $numberOfLegs,
        public string $nickname = '',
    ) {
        if ($weightInKgs < 100) {
            throw new InvalidArgumentException('The weight is too small!');
        }
        if ($numberOfLegs !== 4) {
            throw new InvalidArgumentException('The number of legs is too little or too big');
        }
    }
}

$cow = new AnimalDto(weightInKgs: 500, numberOfLegs: 4);
echo $cow->weightInKgs; // 500
// $cow->weightInKgs = 700; — ошибка: свойство readonly.

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

Когда readonly недостаточно

Если объект должен менять состояние, но каждая мутация требует проверки — нужны методы-команды. Например:

PHP
<?php

final class Cart
{
    private array $items = [];

    public function addItem(string $sku, int $quantity): void
    {
        if ($quantity <= 0) {
            throw new InvalidArgumentException('Quantity must be positive.');
        }

        $this->items[$sku] = ($this->items[$sku] ?? 0) + $quantity;
    }

    public function getItems(): array
    {
        return $this->items;
    }
}

Здесь getItems() — не «геттер ради геттера», а осознанная точка доступа к внутреннему состоянию. Если бы метод назывался setItems(), это фактически означало бы прямое присваивание всего массива — потенциальная дыра для некорректных данных. Поэтому метод добавления называется по действию, а не по свойству.

Геттеры, сеттеры и подсказки IDE

Явные методы дают статическому анализатору точную информацию. Опечатка в имени свойства немедленно подсвечивается. В случае с __get / __set анализатор не может знать, какие имена допустимы, поэтому любые ошибки всплывают только в рантайме.

Сравните:

  • $cow->setWeihgt(500) — ошибка видна сразу, метод не существует.
  • $cow->weihgt = 500 — если работает __set, это молча создаст новое поле и не вызовет ошибок.

Современные IDE (PhpStorm, VS Code с PHP Intelephense) намного лучше работают с явными методами: автодополнение, рефакторинг по кодовой базе, поиск использований. Магические методы оборвали бы эти связи.

Когда __get и __set всё-таки уместны

Не стоит полностью списывать магию со счетов. Есть сценарии, где она уместна:

  • Прокси-объекты и ленивая загрузка. Например, модель, которая подгружает данные из хранилища при первом обращении к свойству.
  • Совместимость с legacy-кодом. Если существующий API ожидает обращение к свойствам, а внутренняя структура изменилась.
  • Отладка и логирование. Перехват факта чтения или записи свойства без изменения основного кода.

Важно, чтобы в таких случаях набор обрабатываемых имён был либо строго ограничен, либо задокументирован. Не нужно использовать __get как «дешёвую» замену обычным публичным свойствам.

Сводная таблица подходов

СитуацияЧто использовать
Данные только хранятся, валидация не нужнаПубличное свойство
Данные неизменяемы после созданияReadonly-класс или readonly-свойства
Изменение требует проверки инвариантовМетод-команда (например, setWeight())
Чтение требует вычисления или фильтрацииМетод-запрос (например, getItems())
Доступ через прокси, ленивая загрузка__get / __set
Динамический набор произвольных значенийАссоциативный массив или stdClass

Чек-лист: как выбрать правильный подход

  • Начните с вопроса: «Нужна ли этому свойству какая-то проверка или побочный эффект при записи?» Если нет — публичное свойство или readonly.
  • Если валидация нужна, назовите метод по действию. setWeight() — хорошо. changeWeightTo() — ещё лучше, если изменение веса должно уведомить пастуха.
  • Если чтение не является тривиальным возвратом значения, используйте метод. getFormattedPrice() — нормально, getPrice() как просто return $this->price; — можно, если price приватное и не должно изменяться снаружи.
  • Не делайте getX() и setX() для каждого поля автоматически. Это механическая привычка из Java, которая в PHP создаёт лишний шум.
  • Используйте declare(strict_types=1) и типизованные параметры. В сеттере int $weight отсеивает строки и null ещё до вызова валидации.
  • Если класс разрастается и __set начинает напоминать простыню из if — переделывайте в явные методы. Магический метод должен оставаться простым мостом, а не бизнес-правилом.
  • Помните: публичное свойство — самый дешёвый и читабельный вариант. Делайте его приватным только тогда, когда появляется реальная причина: валидация, вычисление, инкапсуляция изменений.

Частые вопросы

Стоит ли автоматически генерировать геттеры и сеттеры для всех свойств класса в PHP?

Нет, это механическая практика, порождающая «шелуху». В PHP публичное свойство работает быстрее и читается лучше, чем пара методов. Вводите доступ через методы только там, где есть валидация, вычисление или инкапсуляция изменения.

Чем заменить магические __get и __set в современном PHP?

Для проверки входных данных используйте явные методы-команды вроде setWeight(int $weight): void. Для неизменяемых DTO — readonly-классы. Для динамических наборов данных — ассоциативные массивы или stdClass.

Когда __get и __set действительно полезны?

В прокси-объектах, ленивой загрузке данных из БД, логировании обращений к свойствам и при поддержке legacy-кода, где API ожидает обращение к свойствам, но внутренняя структура изменилась. В таких случаях ограничивайте список обрабатываемых имён.

Чем readonly-свойства PHP 8.1 лучше классических геттеров?

Они короче: вы объявляете свойства в конструкторе и не пишете тела методов доступа. Тип и доступность задаются явно типом свойства. Изменение невозможно после инициализации, что гарантирует неизменяемость на уровне языка, а не на уровне соглашения.

Справка по теме

Ещё в разделе «Возможности PHP»

Релиз PHP 7: что изменилось и как перейти на PHP 8

Что изменилось в PHP 7: производительность, скалярные типы, типы возврата, операторы ?? и <=>. План перехода с PHP 7.x на PHP 8.3–8.5 с проверкой совместимости.

7 мин

Возможности PHP 5.6 и их развитие в PHP 8.x

Разбираем ключевые возможности PHP 5.6: variadic-функции, оператор **, импорт функций и константные выражения. Как это работает в PHP 8.3–8.5.

6 мин

Принцип открытости/закрытости в PHP

Как применять принцип открытости/закрытости в PHP. Сравнение наследования и композиции, абстракции и интерфейсы, типизированные коллекции, стратегии.

9 мин

Почему некоторые PHP-разработчики предпочитают статические API

Разбираем, почему статические методы до сих пор популярны в PHP, чем они удобны и опасны, и как фасады Laravel совмещают статику с DI.

6 мин