تنفيذ الواجهات

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

الآن بعد أن فهمت ماهية الواجهات (interfaces)، دعنا نرى كيفية تنفيذها فعلياً. تقوم الفئة (class) بتنفيذ واجهة باستخدام الكلمة المفتاحية implements، ويجب أن توفر تنفيذات ملموسة لجميع الأساليب (methods) المعلن عنها في تلك الواجهة.

<?php
interface Printable {
    public function print();
}

class Document implements Printable {
    private $content;
    
    public function __construct($content) {
        $this->content = $content;
    }
    
    public function print() {
        return "Printing: " . $this->content;
    }
}

$doc = new Document("Hello World");
echo $doc->print();

المخرجات:

Printing: Hello World

تقوم الفئة Document بتنفيذ Printable من خلال توفير نسختها الخاصة من الدالة print(). إذا نسيت تنفيذ دالة مطلوبة، سيقوم PHP برمي خطأ فادح.

يمكن للأصناف المختلفة تنفيذ نفس الواجهة بطريقتها الخاصة:

<?php
class Invoice implements Printable {
    private $amount;
    
    public function __construct($amount) {
        $this->amount = $amount;
    }
    
    public function print() {
        return "Invoice Total: $" . $this->amount;
    }
}

$invoice = new Invoice(150);
echo $invoice->print();

المخرجات:

Invoice Total: $150

كلا من Document و Invoice يستوفيان عقد Printable، ولكن كل منهما يتعامل مع الطباعة بشكل مختلف بناءً على الغرض منه.

نقطة رئيسية: استخدم implements لربط فئة (class) بواجهة (interface)، ثم قم بتعريف جميع الأساليب (methods) المطلوبة. توفر كل فئة تنفيذية منطقها الخاص مع ضمان وجود نفس تواقيع الأساليب (method signatures).

التحدي

سهل

لنقم ببناء نظام مراسلة يوضح كيف يمكن للفئات المختلفة تنفيذ نفس الواجهة (interface) بطرقها الفريدة الخاصة.

ستقوم بإنشاء ثلاثة ملفات تعمل معاً للتعامل مع أنواع مختلفة من الرسائل:

Messageable.php — قم بتعريف الواجهة Messageable مع توقيعين للدوال: compose($content) و deliver(). تحدد هذه الواجهة العقد الذي يجب أن تتبعه جميع أنواع الرسائل.
Email.php — أنشئ فئة Email التي تنفذ Messageable. قم بتضمين ملف الواجهة في الأعلى. يجب أن تحتوي الفئة على خاصية خاصة $recipient وخاصية خاصة $body. يقبل المنشئ (constructor) عنوان المستلم. قم بتنفيذ compose($content) لتخزين المحتوى في $body وإرجاع "Email composed". قم بتنفيذ deliver() لإرجاع "Email to [recipient]: [body]".
SMS.php — أنشئ فئة SMS التي تنفذ أيضاً Messageable. قم بتضمين ملف الواجهة في الأعلى. يجب أن تحتوي الفئة على خاصية خاصة $phoneNumber وخاصية خاصة $text. يقبل المنشئ رقم الهاتف. قم بتنفيذ compose($content) لتخزين المحتوى في $text وإرجاع "SMS composed". قم بتنفيذ deliver() لإرجاع "SMS to [phoneNumber]: [text]".

في main.php، قم بتضمين ملفي Email و SMS. ستتلقى ثلاثة مدخلات: عنوان بريد إلكتروني، ورقم هاتف، ومحتوى رسالة. أنشئ كائن Email باستخدام عنوان البريد الإلكتروني وكائن SMS باستخدام رقم الهاتف. استدعِ compose() مع محتوى الرسالة على كلا الكائنين، مع طباعة كل نتيجة في سطر خاص بها. ثم استدعِ deliver() على كلا الكائنين، مع طباعة كل نتيجة في سطر خاص بها. يجب أن يكون الترتيب: email compose، ثم SMS compose، ثم email deliver، ثم SMS deliver.

تفي كلتا الفئتين بنفس عقد Messageable، ولكن كل واحدة منهما تتعامل مع إنشاء وتسليم الرسائل وفقاً لغرضها الخاص — حيث تعرض رسائل البريد الإلكتروني عنوان المستلم بينما تعرض رسائل SMS رقم الهاتف.

جرّب بنفسك

<?php
require_once 'Email.php';
require_once 'SMS.php';

// قراءة المدخلات
$emailAddress = trim(fgets(STDIN));
$phoneNumber = trim(fgets(STDIN));
$messageContent = trim(fgets(STDIN));

// TODO: إنشاء كائن Email باستخدام عنوان البريد الإلكتروني

// TODO: إنشاء كائن SMS باستخدام رقم الهاتف

// TODO: استدعاء compose() على كلا الكائنين وطباعة النتائج
// الترتيب: email compose، ثم SMS compose

// TODO: استدعاء deliver() على كلا الكائنين وطباعة النتائج
// الترتيب: email deliver، ثم SMS deliver
?>