حل تعارض السمات

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

عندما تُعرّف سمتان (traits) دوالاً بنفس الاسم، يُصدر PHP خطأً فادحاً. يجب عليك إخبار PHP صراحةً بكيفية التعامل مع هذا التعارض باستخدام المعاملين insteadof و as.

<?php
trait FileLogger {
    public function log(string $message): void {
        echo "File: $message";
    }
}

trait DatabaseLogger {
    public function log(string $message): void {
        echo "DB: $message";
    }
}

class Application {
    use FileLogger, DatabaseLogger {
        FileLogger::log insteadof DatabaseLogger;
        DatabaseLogger::log as logToDatabase;
    }
}

$app = new Application();
$app->log("Error occurred");
$app->logToDatabase("Error occurred");

المخرجات:

File: Error occurred
DB: Error occurred

يختار عامل التشغيل insteadof أي طريقة من طرق الـ trait سيتم استخدامها عند حدوث تعارض. في هذا المثال، تتفوق FileLogger::log وتصبح هي طريقة log() الافتراضية. يقوم عامل التشغيل as بإنشاء اسم مستعار (alias)، مما يتيح لك الوصول إلى طريقة الـ trait الأخرى باسم مختلف.

يمكنك أيضاً استخدام as لتغيير مستوى الوصول للطريقة (method visibility):

<?php
trait Greeting {
    public function sayHello(): void {
        echo "Hello!";
    }
}

class Person {
    use Greeting {
        sayHello as private;
    }
}

هذا يجعل sayHello() خاصاً داخل فئة Person، على الرغم من كونه عاماً في الـ trait. يمنحك حل التعارضات تحكماً دقيقاً في كيفية دمج أساليب الـ trait داخل فئاتك.

التحدي

سهل

لنقم ببناء نظام إشعارات حيث يمكن لقنوات مختلفة إرسال الرسائل، ولكننا نحتاج إلى حل التعارضات عندما توفر سمات (traits) متعددة نفس اسم الدالة.

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

EmailNotifier.php — أنشئ trait يسمى EmailNotifier مع دالة notify(string $message) تعيد "Email: [message]".
SmsNotifier.php — أنشئ trait يسمى SmsNotifier مع دالة notify(string $message) تعيد "SMS: [message]".
AlertService.php — أنشئ كلاس AlertService يستخدم كلا الـ traits. وبما أن كلا الـ traits لديهما دالة notify()، فستحتاج إلى حل هذا التعارض:
- استخدم EmailNotifier::notify كدالة notify() الافتراضية
- أنشئ اسماً مستعاراً (alias) باسم notifyBySms لدالة SmsNotifier::notify
أضف أيضاً دالة notifyAll(string $message) تقوم باستدعاء كلتا دالتي الإشعارات وتعيدهما مدمجتين في أسطر منفصلة.
main.php — قم بتضمين جميع الملفات اللازمة وأنشئ كائن AlertService. ستتلقى مدخلاً واحداً: سلسلة نصية للرسالة. اطبع ثلاثة أسطر:
- نتيجة استدعاء notify() مع الرسالة
- نتيجة استدعاء notifyBySms() مع الرسالة
- نتيجة استدعاء notifyAll() مع الرسالة

يوضح هذا كيف يقوم insteadof بتحديد أي دالة من الـ trait هي التي تفوز عند وجود تعارض في التسمية، بينما يتيح لك as الاحتفاظ بالوصول إلى دالة الـ trait الأخرى تحت اسم مختلف.

ورقة مرجعية

عندما تحدد سمات (traits) متعددة طرقاً (methods) بنفس الاسم، تتطلب لغة PHP حلاً صريحاً للتعارض باستخدام عاملي insteadof و as.

يختار عامل insteadof طريقة السمة التي سيتم استخدامها كافتراضية:

<?php
trait FileLogger {
    public function log(string $message): void {
        echo "File: $message";
    }
}

trait DatabaseLogger {
    public function log(string $message): void {
        echo "DB: $message";
    }
}

class Application {
    use FileLogger, DatabaseLogger {
        FileLogger::log insteadof DatabaseLogger;
        DatabaseLogger::log as logToDatabase;
    }
}

$app = new Application();
$app->log("Error occurred"); // File: Error occurred
$app->logToDatabase("Error occurred"); // DB: Error occurred

يقوم عامل as بإنشاء اسم مستعار (alias) لطريقة السمة، مما يسمح بالوصول إليها تحت اسم مختلف.

يمكنك أيضاً استخدام as لتغيير مستوى رؤية الطريقة (method visibility):

<?php
trait Greeting {
    public function sayHello(): void {
        echo "Hello!";
    }
}

class Person {
    use Greeting {
        sayHello as private;
    }
}

جرّب بنفسك

<?php
require_once 'AlertService.php';

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

// TODO: إنشاء مثيل من AlertService

// TODO: طباعة نتيجة استدعاء notify() مع الرسالة

// TODO: طباعة نتيجة استدعاء notifyBySms() مع الرسالة

// TODO: طباعة نتيجة استدعاء notifyAll() مع الرسالة
?>