Magic methodok speciális metódusok (amik __ előtaggal kezdődnek), amelyeket a PHP automatikusan meghív egy objektumon végzett bizonyos műveletek válaszaként — például egy nem létező property elérésekor, egy nem létező metódus meghívásakor, vagy amikor egy objektumot stringgé konvertálunk. Lehetővé teszik, hogy "beleakaszkodj" és testreszabhasd az objektum viselkedését.
{
{ }
{ }
}
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"
A __get/__set elkapja az olyan property-khez való hozzáféréseket, amelyek nem léteznek vagy nem érhetőek el — lehetővé téve a dinamikus property-ket (amelyeket az ORM-ek, config objektumok használnak).
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', [])
A __call/__callStatic elkapja a nem létező metódusok meghívásait — a fluent/dynamic API-khez használják (pl. 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
A magic methodok a PHP objektumviselkedésének testreszabásához fontos funkciók, és megértésük értékes mind a megfelelő alkalmazásuk, mind — különösen — a PHP frameworkök "varázslatának" megértéséhez. Az olyan metódusok, mint a __get/__set (dinamikus property hozzáférés), __call/__callStatic (dinamikus method kezelés), __toString (string konverzió) és __invoke (callable objektumok) lehetővé teszik, hogy az objektumok intelligensen reagáljanak olyan műveletre, amelyeket nem expliciten definiálnak.
Ez az a mechanizmus, amely a framework kényelme mögött dolgozik: a Laravel Eloquent ORM a __get/__set metódusokat használja a model attributumokhoz, a query builder és facades a __call/__callStatic metódusokat használják a fluent dinamikus metódusokhoz, és a config/collection objektumok ezeket végig használják.
A magic methodok felismerése demisztifikálja azt, hogy ezek a frameworkök hogyan működnek, és lehetővé teszi, hogy hasonlóan rugalmas API-kat építs.
A legfontosabb magic methodok ismerete, az, ami mindegyiket kiváltja, és az ezeknek az általános framework felhasználásai gyakorlati tudást jelentenek, amely értékes a kifejező PHP írásához és a frameworkök hatékony használatához/kiterjesztéséhez egyaránt. (A vigyázat: a magic methodok ronthatják az érthetőséget és az IDE támogatást — túl sok használata nehezebben érthető kódot eredményez, így a legjobb, ha szándékosan használod őket valódi dinamikus viselkedéshez, nem pedig alapértelmezettként.)