Metodat magjike janë metoda speciale (me parashtesën __) që PHP i thirr automatikisht në përgjigje të veprimeve të caktuara në një objekt — si aksesimi i një prone të pacaktuar, thirrja e një metode të pacaktuar, ose konvertimi i një objekti në string. Ato ju lejojnë të hakoni dhe të përshtatni sjelljen e objektit.
{
{ }
{ }
}
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 përgjojnë aksesin në prona që nuk ekzistojnë ose nuk janë të arritshme — duke mundësuar prona dinamike (përdorur nga ORM-ët, objektet e konfigurimit).
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 përgjojnë thirrjet për metoda të pacaktuara — përdorur për API-t fluent/dinamike (p.sh. Laravel-i 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
Metodat magjike janë një veçori e rëndësishme e PHP-së për përshtatjen e sjelljës së objektit, dhe kuptimi i tyre është i vlefshëm si për përdorimin e tyre në mënyrën e duhur ashtu edhe — veçanërisht — për të kuptuar se si kornizat (frameworks) e PHP arrijnë "magjinë" e tyre. Metodat si __get/__set (qasja dinamike në prona), __call/__callStatic (trajtimi dinamik i metodave), __toString (konvertimi në string), dhe __invoke (objektet e thirueshëm) lejojnë objektet të përgjigjen në mënyrë inteligjente ndaj operacioneve që ato nuk e përcaktojnë në mënyrë eksplicite.
Kjo është mekanizmi pas shumë lehtësirave të kornizës: Laravel-i Eloquent ORM përdor __get/__set për atributet e modelit, query builder-i dhe facades-at e tij përdorin __call/__callStatic për metoda dinamike fluent, dhe objektet e konfigurimit/koleksionit përdorin këto në të gjithë.
Njohja e metodave magjike demistifikon se si funksionojnë këto korniza dhe ju lejon të ndërtoni API-t po aq fleksible.
Dija për metodat kryesore magjike, çfarë aktivizon secilën, dhe përdorimet e tyre të zakonshme në korniza është njohuri praktike si për shkrimin e PHP-je shprehuese ashtu edhe për përdorimin/zgjerimin efektiv të kornizave të ndërtuara në to. (Paralajmërimi: metodat magjike mund të dëmtojnë qartësinë dhe mbështetjen e IDE-s — përdorimi i tepruar i tyre e bën kodin më të vështirë për t'u kuptuar, kështu që ato përdoren më mirë me qëllim për sjelljen e vërtetë dinamike, jo si parazgjedhje.)