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

جزء من قسم البرمجة كائنية التوجه في رحلة PHP على Coddy. الدرس 28 من 91.

الآن بعد أن فهمت ما هي الواجهات، دعنا نرَ كيفية تنفيذها فعليًا. يطبّق الصنف واجهةً باستخدام الكلمة المفتاحية 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;
    }
}

$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 لربط فئة بواجهة، ثم عرّف جميع الأساليب المطلوبة. توفّر كل فئة تطبّق الواجهة منطقها الخاص، مع ضمان وجود توقيعات الأساليب نفسها.

التحدي

سهل

لنبنِ نظام مراسلة يوضّح كيف يمكن للفئات المختلفة أن تطبّق الواجهة نفسها بطرقها الفريدة.

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

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

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

تفي كلتا الفئتين بالعقد نفسه 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() على كلا الكائنين واطبع النتائج
// Order: email compose, then SMS compose

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