Magične metode so posebne metode (pred katere je postavljen __), ki jih PHP samodejno kliče kot odziv na določena dejanja s predmetom — kot so dostop do nedoločene lastnosti, klic nedoločene metode ali pretvorba predmeta v niz. Omogočajo vam, da se priključite na obnašanje predmeta in ga prilagodite.
{
{ }
{ }
}
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 prestrežejo dostop do lastnosti, ki ne obstajajo ali niso dostopne — omogočajo dinamične lastnosti (ki jih uporabljajo ORM-i, objekti konfiguracije).
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 prestrežejo klice nedoločenih metod — uporabljajo se za fluent/dinamične API-je (npr. Laravel-jev gradnik poizvedb, fasade).
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
Magične metode so pomembna PHP funkcionalnost za prilagajanje obnašanja predmetov, razumevanje pa je dragoceno tako za njihovo primerno uporabo kot — še posebej — za razumevanje, kako PHP ogrodja dosežejo svojo »magijo«. Metode kot __get/__set (dinamični dostop do lastnosti), __call/__callStatic (dinamično rokovanje z metodami), __toString (pretvorba v niz) in __invoke (predmeti, ki se lahko kličejo) omogočajo predmetom, da se inteligentno odzvejo na operacije, ki jih eksplicitno ne definirajo.
To je mehanizem za večino udobja ogrodij: Laravel-jev Eloquent ORM uporablja __get/__set za atribute modelov, njegov gradnik poizvedb in fasade uporabljajo __call/__callStatic za fluent dinamične metode, objekti konfiguracije in zbirk pa to uporabljajo povsod.
Prepoznavanje magičnih metod razjasnilo kako delujejo ta ogrodja in vam omogoči, da zgradite podobno fleksibilne API-je.
Znanje ključnih magičnih metod, kaj sprožija vsako in njihove pogosta uporaba v ogrodjih je praktično znanje tako za pisanje izrazitega PHP-ja kot za učinkovito uporabo/razširitev ogrodij, ki so zgrajena nanje. (Opomba: magične metode lahko škodijo jasnosti in podpori IDE — njihova prekomerna raba naredi kodo težje razumljivo, zato so najbolje uporabljene načrtno za resnično dinamično obnašanje, ne kot privzeto izbiro.)