مقدمة في الميثودات السحرية

جزء من قسم Object Oriented Programming في رحلة PHP على Coddy — الدرس 44 من 91.

الدوال السحرية (Magic methods) هي دوال خاصة في PHP تبدأ بشرطتين سفليتين مزدوجتين (__) ويتم استدعاؤها تلقائيًا بواسطة PHP استجابةً لأحداث أو إجراءات معينة. لقد استخدمت بالفعل اثنين منها: __construct() و __destruct().

تتيح لك هذه الأساليب الربط بسلوك PHP الداخلي وتخصيص كيفية استجابة كائناتك للعمليات الشائعة.

على سبيل المثال، ماذا يحدث عندما تحاول طباعة كائن (object)؟ أو الوصول إلى خاصية (property) غير موجودة؟ تمنحك الأساليب السحرية (Magic methods) التحكم في هذه المواقف.

إليك نظرة عامة سريعة على أكثر الأساليب السحرية (magic methods) استخداماً:

الطريقة	يتم استدعاؤها عند
`__construct()`	يتم إنشاء الكائن
`__destruct()`	يتم تدمير الكائن
`__toString()`	يتم استخدام الكائن كسلسلة نصية
`__get()`	الوصول إلى خاصية غير معرفة
`__set()`	تعيين قيمة لخاصية غير معرفة
`__call()`	استدعاء طريقة غير معرفة
`__clone()`	يتم استنساخ الكائن

<?php
class Book {
    public function __construct(
        private string $title
    ) {}
    
    public function __toString(): string {
        return "Book: " . $this->title;
    }
}

$book = new Book("PHP Mastery");
echo $book;

المخرجات:

Book: PHP Mastery

بدون __toString()، فإن محاولة عرض كائن (echo) ستؤدي إلى حدوث خطأ. تقوم الطريقة السحرية باعتراض هذا الإجراء وإرجاع تمثيل نصي بدلاً من ذلك. في الدروس القادمة، سنستكشف كل طريقة سحرية بالتفصيل.

التحدي

سهل

دعنا نبني نظام كتالوج أفلام يعرفك على الطرق السحرية (magic methods). ستقوم بإنشاء فئة Movie تستخدم __construct() لتهيئة بيانات الفيلم و __toString() لتوفير تمثيل نصي نظيف عند طباعة الكائن.

ستقوم بتنظيم الكود الخاص بك عبر ملفين:

Movie.php — أنشئ فئة Movie تمثل الأفلام في الكتالوج الخاص بك. استخدم خاصية "constructor promotion" لتعريف خصائص خاصة (private) لكل من $title (سلسلة نصية)، و $director (سلسلة نصية)، و $year (عدد صحيح). قم بتنفيذ الطريقة السحرية __toString() لإرجاع سلسلة نصية منسقة: "[title] ([year]) - Directed by [director]". يتيح ذلك طباعة كائنات الأفلام الخاصة بك مباشرة باستخدام echo دون استدعاء طريقة منفصلة.
main.php — قم بتضمين ملف Movie. ستتلقى ثلاثة مدخلات: عنوان الفيلم، واسم المخرج، وسنة الإصدار. أنشئ مثيلاً (instance) من Movie باستخدام هذه القيم (قم بتحويل السنة إلى عدد صحيح). ثم ببساطة قم بطباعة كائن الفيلم مباشرة — سيتم استدعاء طريقة __toString() تلقائياً لإنتاج المخرجات.

تكمن روعة __toString() في أن PHP يستدعيها تلقائياً كلما تم استخدام الكائن الخاص بك في سياق نصي. بدلاً من كتابة echo $movie->getInfo();، يمكنك ببساطة كتابة echo $movie; وسيتولى PHP عملية التحويل نيابة عنك. هذا يجعل التعامل مع كائناتك أكثر سهولة وبداهة.

ورقة مرجعية

الطرق السحرية (Magic methods) هي طرق خاصة في PHP تبدأ بشرطتين سفليتين (__) ويتم استدعاؤها تلقائيًا بواسطة PHP استجابةً لأحداث أو إجراءات معينة.

الطرق السحرية الشائعة:

الطريقة	يتم استدعاؤها عند
`__construct()`	إنشاء الكائن
`__destruct()`	تدمير الكائن
`__toString()`	استخدام الكائن كسلسلة نصية
`__get()`	الوصول إلى خاصية غير محددة
`__set()`	تعيين قيمة لخاصية غير محددة
`__call()`	استدعاء طريقة غير محددة
`__clone()`	استنساخ الكائن

تعيد الطريقة __toString() تمثيلاً نصياً للكائن:

<?php
class Book {
    public function __construct(
        private string $title
    ) {}
    
    public function __toString(): string {
        return "Book: " . $this->title;
    }
}

$book = new Book("PHP Mastery");
echo $book; // Output: Book: PHP Mastery

بدون __toString()، ستؤدي محاولة طباعة (echo) الكائن إلى حدوث خطأ. تقوم الطريقة السحرية باعتراض هذا الإجراء وتسمح باستخدام الكائن في سياق نصي.

جرّب بنفسك

<?php

require_once 'Movie.php';

// قراءة المدخلات
$title = trim(fgets(STDIN));
$director = trim(fgets(STDIN));
$year = intval(fgets(STDIN));

// TODO: إنشاء مثيل (instance) من Movie باستخدام قيم المدخلات

// TODO: طباعة كائن الفيلم مباشرة (سيتم استدعاء الدالة __toString() تلقائياً)

?>