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

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

الآن بعد أن فهمت ماهية الواجهات (interfaces)، فلنلقِ نظرة على كيفية تنفيذها فعلياً. تقوم الفئة (class) بتنفيذ واجهة (interface) باستخدام الكلمة المفتاحية 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 بإصدار خطأ فادح (fatal error).

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

<?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 رقم الهاتف.

ورقة مرجعية

تقوم الفئة بتنفيذ واجهة باستخدام الكلمة المفتاحية implements ويجب أن توفر تطبيقات ملموسة لجميع الأساليب المعلن عنها في تلك الواجهة:

<?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;
    }
}

يمكن لعدة فئات تنفيذ نفس الواجهة، حيث توفر كل منها تطبيقها الخاص:

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

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

جرّب بنفسك

<?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() على كلا الكائنين وطباعة النتائج
// الترتيب: إنشاء البريد الإلكتروني، ثم إنشاء الرسالة النصية القصيرة

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