استخدام سمات متعددة

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

إن استخدام سمة (trait) واحدة مفيد، ولكن القوة الحقيقية تظهر عند دمج سمات متعددة في فئة (class) واحدة. تتيح لك PHP تضمين أي عدد تريده من السمات، مما يمنح فئتك قدرات من مصادر متعددة في وقت واحد.

لاستخدام سمات (traits) متعددة، ما عليك سوى إدراجها مفصولة بفاصلات بعد الكلمة المفتاحية use:

<?php
trait Timestampable {
    public function getTimestamp(): string {
        return date('Y-m-d H:i:s');
    }
}

trait Identifiable {
    private string $id;
    
    public function generateId(): void {
        $this->id = uniqid('id_');
    }
    
    public function getId(): string {
        return $this->id;
    }
}

class Post {
    use Timestampable, Identifiable;
    
    public function __construct(public string $title) {
        $this->generateId();
    }
}

$post = new Post("Hello World");
echo $post->getId() . " - " . $post->getTimestamp();

المخرجات:

id_6789abc123 - 2024-01-15 10:30:00

تمتلك فئة Post الآن دوالاً (methods) من كلا السمتين (traits). تساهم كل سمة بوظيفتها الخاصة - حيث توفر Timestampable دوالاً متعلقة بالوقت بينما تتعامل Identifiable مع المعرفات الفريدة (unique IDs). يحافظ هذا النهج على تركيز كل سمة على مسؤولية واحدة، مما يجعل الكود الخاص بك أكثر نمطية وقابلية لإعادة الاستخدام.

ماذا يحدث عندما تمتلك صفتان (traits) دوالاً (methods) بنفس الاسم؟ هذه حالة تعارض سنستكشفها في الدرس القادم.

التحدي

سهل

لنقم ببناء نظام إدارة منتجات يجمع بين سمات (traits) متعددة لمنح المنتجات إمكانيات التسعير والمخزون معاً. ستتعامل كل سمة مع مسؤولية واحدة، وستكتسب فئة المنتج (product class) الخاصة بك الوظائف من كلتيهما.

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

Priceable.php — أنشئ سمة تسمى Priceable تتعامل مع وظائف التسعير. يجب أن تحتوي السمة على:
- خاصية خاصة $price (float)
- دالة setPrice(float $price) تقوم بتخزين السعر
- دالة getPrice() تقوم بإرجاع السعر
- دالة getFormattedPrice() تقوم بإرجاع السعر منسقاً كـ "$[price]" مع منزلتين عشريتين
Stockable.php — أنشئ سمة تسمى Stockable تدير المخزون. يجب أن تحتوي السمة على:
- خاصية خاصة $stock (integer)
- دالة setStock(int $quantity) تقوم بتخزين كمية المخزون
- دالة getStock() تقوم بإرجاع المخزون الحالي
- دالة isInStock() تقوم بإرجاع true إذا كان المخزون أكبر من 0، و false خلاف ذلك
main.php — قم بتضمين ملفي السمات وأنشئ فئة Product تستخدم كلاً من سمات Priceable و Stockable. استخدم خاصية constructor promotion لتعريف خاصية $name عامة. يجب أن يقبل المنشئ (constructor) أيضاً سعراً وكمية مخزون، مع استخدام دوال السمات لتعيينهما.
ستتلقى ثلاثة مدخلات: اسم المنتج، والسعر، وكمية المخزون. أنشئ منتجاً بهذه القيم واطبع أربعة أسطر:
- اسم المنتج
- السعر المنسق (باستخدام getFormattedPrice())
- كمية المخزون
- "Available" إذا كان متوفراً في المخزون، أو "Out of stock" إذا لم يكن كذلك

يوضح هذا كيفية عمل السمات المتعددة معاً — تكتسب فئة Product الخاصة بك إمكانيات التسعير من سمة واحدة وإدارة المخزون من سمة أخرى، مما يحافظ على فصل كل اهتمام بدقة مع دمجها في منتج كامل الميزات.

جرّب بنفسك

<?php
require_once 'Priceable.php';
require_once 'Stockable.php';

// TODO: إنشاء فئة Product تستخدم كلاً من السمات (traits) ‏Priceable و Stockable
// استخدم خاصية ترقية المنشئ (constructor promotion) لخاصية $name العامة
// يجب أن يقبل المنشئ name و price و stock، ويستخدم أساليب السمات لتعيين السعر والمخزون

class Product {
    // TODO: استخدم السمات (traits) هنا

    // TODO: قم بتنفيذ المنشئ مع ترقية المنشئ لـ $name
    // وتعيين السعر والمخزون باستخدام أساليب السمات
}

// قراءة المدخلات
$name = trim(fgets(STDIN));
$price = floatval(trim(fgets(STDIN)));
$stock = intval(trim(fgets(STDIN)));

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

// TODO: طباعة اسم المنتج
// TODO: طباعة السعر المنسق باستخدام getFormattedPrice()
// TODO: طباعة كمية المخزون
// TODO: طباعة "Available" إذا كان متوفراً في المخزون، أو "Out of stock" إذا لم يكن كذلك
?>