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

جزء من قسم 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 الآن دوالاً من كلا السمتين (traits). تساهم كل سمة بوظيفتها الخاصة - حيث توفر Timestampable دوالاً متعلقة بالوقت بينما تتعامل Identifiable مع المعرفات الفريدة. هذا النهج يجعل كل سمة تركز على مسؤولية واحدة، مما يجعل الكود الخاص بك أكثر نمطية وقابلية لإعادة الاستخدام.

ماذا يحدث عندما تمتلك صفتان (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 الخاصة بك إمكانيات التسعير من سمة واحدة وإدارة المخزون من سمة أخرى، مما يحافظ على فصل كل اهتمام بدقة مع دمجها في منتج كامل الميزات.

ورقة مرجعية

لاستخدام سمات (traits) متعددة في فئة (class)، قم بإدراجها مفصولة بفواصل بعد الكلمة المفتاحية 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

تساهم كل سمة (trait) بوظائفها الخاصة في الفئة. يحافظ هذا النهج على تركيز كل سمة على مسؤولية واحدة، مما يجعل الكود أكثر نمطية وقابلية لإعادة الاستخدام.

جرّب بنفسك

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

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

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

    // 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" إذا لم يكن كذلك
?>