الدوال السحرية (Magic methods) هي دوال خاصة (مسبوقة بـ __) تستدعيها PHP تلقائيًا استجابةً لأفعال معينة على كائن — مثل الوصول إلى خاصية غير معرّفة، أو استدعاء دالة غير معرّفة، أو تحويل كائن إلى نص. تتيح لك هذه الدوال الاتصال بسلوك الكائن وتخصيصه.
{
{ }
{ }
}
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 الوصول إلى الخصائص التي لا توجد أو التي لا يمكن الوصول إليها — مما يتيح الخصائص الديناميكية (المستخدمة بواسطة أدوات ORM وكائنات الإعدادات).
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 استدعاءات الدوال غير المعرّفة — وتُستخدم لواجهات API السلسة/الديناميكية (مثل query builder والـ facades في Laravel).
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
الدوال السحرية ميزة مهمة في PHP لتخصيص سلوك الكائنات، وفهمها قيّم سواء لاستخدامها بشكل مناسب أو — وهذا الأهم — لفهم كيف تحقق أطر عمل PHP "سحرها". الدوال مثل __get/__set (الوصول الديناميكي للخصائص)، و __call/__callStatic (المعالجة الديناميكية للدوال)، و __toString (التحويل إلى نص)، و __invoke (الكائنات القابلة للاستدعاء) تتيح للكائنات الاستجابة بذكاء للعمليات التي لا تعرّفها صراحةً.
هذا هو الآلية وراء الكثير من سهولة أطر العمل: يستخدم Eloquent ORM في Laravel الدالتين __get/__set لخصائص النموذج، ويستخدم query builder والـ facades الدالتين __call/__callStatic للدوال الديناميكية السلسة، وتستخدم كائنات الإعدادات والمجموعات هذه الدوال على نطاق واسع.
التعرّف على الدوال السحرية يزيل الغموض عن كيفية عمل هذه الأطر ويتيح لك بناء واجهات API مرنة مماثلة.
معرفة الدوال السحرية الرئيسية، وما يُشغّل كل منها، واستخداماتها الشائعة في الأطر، هي معرفة عملية سواء لكتابة PHP معبّرة أو لاستخدام/توسيع الأطر المبنية عليها بفعالية. (التحذير: قد تضر الدوال السحرية بالوضوح ودعم بيئة التطوير المتكاملة (IDE) — فالإفراط في استخدامها يجعل الكود أصعب فهمًا، لذا من الأفضل استخدامها بتعمّد للسلوك الديناميكي الحقيقي، وليس كخيار افتراضي.)