Magijos metodai yra specialūs metodai (pradedami __), kuriuos PHP automatiškai iškviečia reaguodamas į tam tikrus objekto veiksmus — kaip prieiga prie neegzistuojančios savybės, neegzistuojančio metodo iškvietimas ar objekto konvertavimas į eilutę. Jie leidžia jums užhakinti ir suderinti objekto elgesį.
{
{ }
{ }
}
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 perimti prieigą prie savybių, kurios neegzistuoja arba nėra pasiekiamos — įgalinant dinamines savybes (naudojamos ORM, konfigūracijos objektuose).
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 perimti neegzistuojančių metodų iškvietimus — naudojami laiškinėms/dinaminėms API (pvz. Laravel užklausų kūrėjas, fasadai).
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
Magijos metodai yra svarbi PHP funkcija objekto elgesio suderinimui, ir jų supratimas yra vertingas tiek juos naudojant tinkamai, tiek — ypač — suprantant, kaip PHP karkasai pasiekia savo "magiją". Metodai, tokie kaip __get/__set (dinaminė savybės prieiga), __call/__callStatic (dinaminis metodo tvarkymas), __toString (konvertavimas į eilutę) ir __invoke (iškviestinieji objektai) leidžia objektams protingai reaguoti į operacijas, kurias jie aiškiai neapibrėžia.
Tai yra mechanizmas, stovintis už daugelio karkaso patogumų: Laravel Eloquent ORM naudoja __get/__set modelio atributams, jo užklausų kūrėjas ir fasadai naudoja __call/__callStatic laiškinėms dinaminėms metodams, ir konfigūracijos/rinkinio objektai juos naudoja visame.
Magijos metodų atpažinimas demistifikuoja, kaip šie karkasai veikia, ir leidžia sukurti panašiai lankstias API.
Žinoti pagrindinius magijos metodus, kas kiekvieną iškviečia ir jų bendrus karkaso naudojimus yra praktinis žinios būdas tiek rašyti išraiškingą PHP, tiek efektyviai naudoti/pratęsti karkasus, pagrįstus jais. (Įspėjimas: magijos metodai gali pakenkti aiškumui ir IDE palaikymui — per dažnai jie naudojami, kodas tampa sunkesnis suprasti, todėl jie geriausiai naudojami sąmoningai tikram dinaminiam elgesiui, ne kaip numatytasis variantas.)