Magické metody jsou speciální metody (prefixované __), které PHP volá automaticky v odpovědi na určité akce s objektem — jako přístup k neexistující vlastnosti, volání neexistující metody nebo převod objektu na řetězec. Umožňují vám zaháknout se na chování objektu a upravit ho.
{
{ }
{ }
}
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 zachycují přístup k vlastnostem, které neexistují nebo nejsou přístupné — umožňují dynamické vlastnosti (používáno ORM, objekty konfigurace).
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 zachycují volání neexistujících metod — používáno pro fluent/dynamická API (např. Laravel query builder, 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
Magické metody jsou důležitá funkce PHP pro přizpůsobení chování objektu a jejich pochopení je cenné jak pro jejich správné použití, tak — zejména — pro pochopení toho, jak PHP frameworky dosahují své "magic". Metody jako __get/__set (dynamický přístup k vlastnostem), __call/__callStatic (dynamické zpracování metod), __toString (převod na řetězec) a __invoke (callable objekty) umožňují objektům inteligentně reagovat na operace, které výslovně nedefinují.
To je mechanismus za spoustou výhod frameworku: Laravel Eloquent ORM používá __get/__set pro atributy modelu, jeho query builder a facades používají __call/__callStatic pro fluent dynamické metody a config/collection objekty je používají v celém frameworku.
Rozpoznání magických metod demystifikuje, jak tyto frameworky fungují, a umožňuje vám vytvářet podobně flexibilní API.
Znalost klíčových magických metod, co spouští každou z nich a jejich běžné použití ve frameworcích je praktická znalost pro psaní výrazného PHP a efektivní používání/rozšiřování frameworků, které na nich jsou postaveny. (Upozornění: magické metody mohou uškodit jasnosti a podpoře IDE — nadměrné používání činí kód těžším na pochopení, takže jsou nejlépe používány záměrně pro skutečné dynamické chování, ne jako výchozí přístup.)