Getter’ы и setter’ы в PHP: магия, которая должна знать своё место
Магические методы __get и __set выглядят удобно, но в типичных сценариях приносят больше вреда, чем пользы. Разбираемся, как в современных версиях PHP организовать контроль доступа к свойствам без потери читабельности и подсказок IDE.
Зачем вообще контролировать доступ к свойствам
Начнём с простого класса:
<?php
declare(strict_types=1);
final class Animal
{
public int $weightInKgs;
}
$cow = new Animal();
$cow->weightInKgs = -100; // Корова с отрицательной массой — это нормально?Если свойство публичное, никто не помешает записать в него мусор. Отрицательный вес, количество ног равное семи, пустую строку вместо статуса — валидация отсутствует. Именно для таких ситуаций и нужны методы доступа. Но реализовывать их можно по-разному.
Магические __get и __set: заманчиво, но опасно
Магические методы перехватывают обращение к недоступным или несуществующим свойствам:
<?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
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
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
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 лучше классических геттеров?
Они короче: вы объявляете свойства в конструкторе и не пишете тела методов доступа. Тип и доступность задаются явно типом свойства. Изменение невозможно после инициализации, что гарантирует неизменяемость на уровне языка, а не на уровне соглашения.