Magic methods خصوصی methods ہیں (جن کا prefix __ ہے) جو PHP خودکار طور پر کال کرتا ہے جب کوئی معین action کسی object پر ہو — جیسے کسی undefined property کو access کرنا، کسی undefined method کو call کرنا، یا کسی object کو string میں تبدیل کرنا۔ یہ آپ کو object کے behavior کو hook اور customize کرنے دیتے ہیں۔
{
{ }
{ }
}
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 ان properties تک رسائی کو intercept کرتے ہیں جو موجود نہیں ہیں یا accessible نہیں ہیں — dynamic properties کو enable کرتے ہوئے (ORMs، config objects میں استعمال ہوتے ہیں)۔
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 undefined methods کی calls کو intercept کرتے ہیں — fluent/dynamic APIs کے لیے استعمال ہوتے ہیں (مثال کے طور پر 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
Magic methods PHP کی ایک اہم خصوصیت ہے object کے behavior کو customize کرنے کے لیے، اور انہیں سمجھنا قیمتی ہے دونوں انہیں مناسب طریقے سے استعمال کرنے کے لیے اور — خاص طور پر — یہ سمجھنے کے لیے کہ PHP frameworks اپنا "magic" کیسے حاصل کرتے ہیں۔ Methods جیسے __get/__set (dynamic property access)، __call/__callStatic (dynamic method handling)، __toString (string conversion)، اور __invoke (callable objects) objects کو ایسے operations کے لیے intelligently جواب دینے دیتے ہیں جو وہ explicitly define نہیں کرتے۔
یہ وہ mechanism ہے جس کی وجہ سے بہت سی framework convenience ہے: Laravel کا Eloquent ORM __get/__set استعمال کرتا ہے model attributes کے لیے، اس کا query builder اور facades __call/__callStatic استعمال کرتے ہیں fluent dynamic methods کے لیے، اور config/collection objects یہ پوری جگہ استعمال کرتے ہیں۔
Magic methods کو پہچاننا ان frameworks کے کام کرنے کے طریقے کو واضح کرتا ہے اور آپ کو اسی طرح کے flexible APIs بنانے دیتا ہے۔
اہم magic methods جاننا، یہ کہ کون سا ہر ایک کو trigger کرتا ہے، اور ان کے عام framework استعمال practical knowledge ہے PHP لکھنے اور effectively استعمال/extend کرنے دونوں کے لیے جو frameworks ان پر بنی ہوئی ہیں۔ (انتباہ: magic methods clarity اور IDE support کو نقصان پہنچا سکتے ہیں — انہیں بہت زیادہ استعمال کرنا code کو سمجھنا مشکل بناتا ہے، تو یہ بہترین طریقے سے deliberately genuine dynamic behavior کے لیے استعمال ہوتے ہیں، default کے طور پر نہیں۔)