Magic methods huma metodi speċjali (prefissat b'__) li PHP tawwali awtomatikament bħala risposta għal ċerti azzjonijiet fuq oġġett — bħal l-aċċess għal proprjetà mhux definita, sejħa għal metodu mhux definit, jew konverżjoni ta' oġġett għal string. Jippermettulek li tgaqqad u tippersonalizza l-imġieba ta' oġġetti.
{
{ }
{ }
}
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 jinterċeptaw l-aċċess għal proprjetajiet li ma jeżistux jew mhumiex aċċessibbli — jippermettu proprjetajiet dinamiċi (użati minn ORMs, objects tal-config).
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 jinterċeptaw sejħat għal metodi mhux definiti — użati għal fluent/dynamic APIs (eż. Laravel's 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
Magic methods huma feature importanti f'PHP għal tippersonalizzazzjoni tal-imġieba ta' oġġetti, u l-fehim tagħhom hu valwuż kemm għall-użu tagħhom b'mod xieraq kif ukoll — speċjalment — għall-fehim ta' kif PHP frameworks jilħqu l-"magic" tagħhom. Metodi bħal __get/__set (dynamic property access), __call/__callStatic (dynamic method handling), __toString (string conversion), u __invoke (callable objects) jippermetu li oġġetti jirrispondu intelliġentement għal operazzjonijiet li ma jiddefinixxuhom espliċitament.
Din hija l-mekkaniżmu waraː l-convenenza tal-framework: Laravel's Eloquent ORM juża __get/__set għal model attributes, il-query builder u facades tiegħu juża __call/__callStatic għal fluent dynamic methods, u config/collection objects juża dawn matul it-tuttal.
L-irkognizzjoni ta' magic methods tispjega kif dawn il-frameworks jaħdmu u tippermetu li tibni APIs flessibili b'istess mod.
Il-għarfien tal-magic methods ewlieni, x'jattiva kull waħda, u l-użi komuni tagħhom fil-frameworks huma għarfien prattiku kemm għall-kitba ta' PHP espressiv kif ukoll għall-użu effettiv/estensjoni tal-frameworks mibnija fuqhom. (Il-caveat: magic methods jistgħu jgħarrqu l-clarity u l-IDE support — l-oversaħħ tagħhom jagħmel il-kodiċi iħxuna biex jinfiehem, għalhekk ħamrux jintużaw b'intenzjoni għal genuine dynamic behavior, mhux bħala default.)