Магические методы — это специальные методы (с префиксом __), которые PHP вызывает автоматически в ответ на определённые действия над объектом — например, доступ к неопределённому свойству, вызов неопределённого метода или преобразование объекта в строку. Они позволяют вам перехватывать и настраивать поведение объектов.
{
{ }
{ }
}
class Container {
private array $data = [];
public function __get($name) { // called on reading an INACCESSIBLE/undefined property
return $this->data[$name] ?? null;
}
public function __set($name, $value) { // called on writing one
$this->data[$name] = $value;
}
public function __isset($name): bool { return isset($this->data[$name]); }
}
$c = new Container();
$c->foo = "bar"; // triggers __set('foo', 'bar')
echo $c->foo; // triggers __get('foo') → "bar"
__get/__set перехватывают доступ к свойствам, которые не существуют или недоступны — обеспечивая динамические свойства (используются в ORM, объектах конфигурации).
class Api {
public function __call($method, $args) { // called for UNDEFINED method calls
return $this->request($method, $args); // e.g. dynamic API methods
}
public static function __callStatic($method, $args) { /* static version */ }
}
$api->getUsers(); // no getUsers() method → __call('getUsers', [])
__call/__callStatic перехватывают вызовы неопределённых методов — используются для fluent/динамических API (например, query builder Laravel, facades).
class Money {
public function __construct(private float $amount) {}
public function __toString(): string { // when the object is used as a string
return '$' . number_format($this->amount, 2);
}
}
echo new Money(9.5); // "$9.50" — __toString called automatically
class Multiplier {
public function __invoke($x) { return $x * 2; } // makes the object CALLABLE
}
$double = new Multiplier();
$double(5); // 10 — __invoke called
Магические методы — это важная возможность PHP для настройки поведения объектов, и их понимание ценно как для корректного использования, так и — особенно — для понимания того, как PHP-фреймворки достигают своей "магии". Методы вроде __get/__set (динамический доступ к свойствам), __call/__callStatic (динамическая обработка методов), __toString (преобразование в строку) и __invoke (вызываемые объекты) позволяют объектам интеллектуально реагировать на операции, которые они не определяют явно.
Этот механизм лежит в основе множества удобств фреймворков: Eloquent ORM Laravel использует __get/__set для атрибутов модели, его query builder и facades используют __call/__callStatic для fluent динамических методов, и объекты конфигурации/коллекций используют их повсюду.
Распознавание магических методов разгадывает, как работают эти фреймворки, и позволяет вам создавать аналогично гибкие API.
Знание ключевых магических методов, того, что их срабатывает, и их типичного использования в фреймворках — это практическое знание как для написания выразительного PHP, так и для эффективного использования и расширения фреймворков, построенных на них. (Оговорка: магические методы могут снизить ясность кода и поддержку IDE — чрезмерное их использование затрудняет понимание кода, поэтому их лучше использовать намеренно для настоящего динамического поведения, а не по умолчанию.)